> ## Documentation Index
> Fetch the complete documentation index at: https://docs.nextmed.med.br/llms.txt
> Use this file to discover all available pages before exploring further.

# MCP Mintlify para desenvolvedores

> Como conectar o MCP da documentação NextMed ao Cursor, VS Code e outras ferramentas, e o que ele permite fazer.

O [Model Context Protocol (MCP)](https://modelcontextprotocol.io/) permite que assistentes de IA consultem a **documentação indexada** no ar serviço em tempo de execução, em vez de depender só da memória do modelo ou de busca genérica na web.

Quando este site estiver publicado no Mintlify, o Mintlify expõe um **servidor MCP HTTP** na URL:

```text theme={"system"}
https://SEU-DOMINIO-DOCUMENTACAO/mcp
```

Substitua por:

* o domínio da sua documentação (ex.: `docs.suaempresa.com`), **ou**
* a URL padrão Mintlify (`https://subdominio.mintlify.app`)

A URL exata aparece no [dashboard Mintlify → MCP](https://dashboard.mintlify.com/products/mcp), após o deploy conectado ao repositório da doc.

<Info>
  Enquanto a doc roda só em **`mint dev` local**, não há servidor MCP público. O MCP fica disponível **após o deploy** no Mintlify (ou em ambiente que exponha o mesmo endpoint `/mcp`).
</Info>

## O que o MCP faz neste projeto

* Expõe uma ferramenta de **busca** sobre o conteúdo que o Mintlify indexou (páginas em `docs.json`, salvo configurações de SEO e `.mintignore`).
* Assistentes (Cursor, Claude, etc.) podem **chamar essa busca** durante a conversa para responder com trechos atuais da doc (API, arquitetura, Plataforma Manager, etc.).

Complemente com o **skill Mintlify** no repositório (`.agents/skills/mintlify`): o MCP traz **conteúdo**; o skill traz **boas práticas** de escrita e componentes Mintlify.

## Parâmetros úteis da busca (quando suportados pelo cliente)

Conforme a [documentação oficial do MCP Mintlify](https://www.mintlify.com/docs/ai/model-context-protocol):

| Parâmetro        | Uso                                                                 |
| ---------------- | ------------------------------------------------------------------- |
| `pageSize`       | Quantidade de resultados (1–50; padrão costuma ser 10).             |
| `scoreThreshold` | Pontuação mínima de relevância (0–1) para filtrar ruído.            |
| `version`        | Filtrar por versão da documentação (se vocês usarem versionamento). |
| `language`       | Filtrar por idioma (`en`, `es`, etc.).                              |

Quem controla o envio desses parâmetros é, em geral, o **cliente MCP** ou o modelo, não o desenvolvedor manualmente em cada pergunta.

## Cursor

<Steps>
  <Step title="Obter a URL do MCP">
    No [dashboard Mintlify](https://dashboard.mintlify.com/products/mcp), copie a URL do servidor MCP (termina em `/mcp`).
  </Step>

  <Step title="Abrir configuração MCP">
    Atalho **Ctrl+Shift+P** (Windows/Linux) ou **Cmd+Shift+P** (macOS) → pesquise **Open MCP settings** → **Add custom MCP** (abre o `mcp.json`).
  </Step>

  <Step title="Registrar o servidor">
    Inclua um bloco com a URL real da sua documentação:

    ```json theme={"system"}
    {
      "mcpServers": {
        "NextMed Docs": {
          "url": "https://SEU-DOMINIO-DOCUMENTACAO/mcp"
        }
      }
    }
    ```

    Use um nome estável (ex.: `NextMed Docs`) para o time reconhecer no chat.
  </Step>

  <Step title="Validar">
    No chat do Cursor, pergunte algo como: “Quais ferramentas MCP estão disponíveis?” e confira se o servidor da documentação aparece.
  </Step>
</Steps>

Documentação Cursor: [Installing MCP servers](https://docs.cursor.com/en/context/mcp#installing-mcp-servers).

## VS Code

Crie ou edite `.vscode/mcp.json` no projeto:

```json theme={"system"}
{
  "servers": {
    "NextMed Docs": {
      "type": "http",
      "url": "https://SEU-DOMINIO-DOCUMENTACAO/mcp"
    }
  }
}
```

Mais detalhes: [MCP servers no VS Code](https://code.visualstudio.com/docs/copilot/chat/mcp-servers).

## Claude (web) e Claude Code

* **Claude (navegador):** [Connectors](https://claude.ai/settings/connectors) → **Add custom connector** → nome + URL `https://.../mcp`.
* **Claude Code (CLI):**

```bash theme={"system"}
claude mcp add --transport http "NextMed Docs" "https://SEU-DOMINIO-DOCUMENTACAO/mcp"
claude mcp list
```

## Limites e indexação

* **Rate limits:** o Mintlify aplica limites por usuário (IP) e por site de documentação. Valores e políticas atualizados estão na [documentação oficial do MCP](https://www.mintlify.com/docs/ai/model-context-protocol); evite automação agressiva contra o endpoint `/mcp`.
* Por padrão, o MCP indexa páginas que estão na **navegação** do `docs.json`. Para incluir páginas “escondidas” na busca, avaliem `seo.indexing` no `docs.json` (veja a [doc Mintlify sobre MCP](https://www.mintlify.com/docs/ai/model-context-protocol)).
* Arquivos excluídos por **`.mintignore`** não entram na busca.

## Boas práticas para o time

* Conectar o MCP da doc **NextMed** quando forem trabalhar em integrações com a API ou conteúdo da Manager.
* Formular prompts **específicos** (“Como autenticar chamadas ao Admin Service?”) para o modelo priorizar busca na doc certa.
* Desligar servidores MCP que não estejam em uso para economizar contexto, se o cliente carregar muitos de uma vez.

## Referências

* [Model Context Protocol — Mintlify](https://www.mintlify.com/docs/ai/model-context-protocol)
* [Tutorial MCP (servidor remoto)](https://modelcontextprotocol.io/docs/tutorials/use-remote-mcp-server#connecting-to-a-remote-mcp-server)