Skip to main content
O Model Context Protocol (MCP) 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: 
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, após o deploy conectado ao repositório da doc.
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).

​
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:
ParâmetroUso
pageSizeQuantidade de resultados (1–50; padrão costuma ser 10).
scoreThresholdPontuação mínima de relevância (0–1) para filtrar ruído.
versionFiltrar por versão da documentação (se vocês usarem versionamento).
languageFiltrar 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

1

Obter a URL do MCP

No dashboard Mintlify, copie a URL do servidor MCP (termina em /mcp).
2

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).
3

Registrar o servidor

Inclua um bloco com a URL real da sua documentação:
{
  "mcpServers": {
    "NextMed Docs": {
      "url": "https://SEU-DOMINIO-DOCUMENTACAO/mcp"
    }
  }
}
Use um nome estável (ex.: NextMed Docs) para o time reconhecer no chat.
4

Validar

No chat do Cursor, pergunte algo como: “Quais ferramentas MCP estão disponíveis?” e confira se o servidor da documentação aparece.
Documentação Cursor: Installing MCP servers.

​
VS Code

Crie ou edite .vscode/mcp.json no projeto: 
{
  "servers": {
    "NextMed Docs": {
      "type": "http",
      "url": "https://SEU-DOMINIO-DOCUMENTACAO/mcp"
    }
  }
}
Mais detalhes: MCP servers no VS Code.

​
Claude (web) e Claude Code

  • Claude (navegador): Connectors → Add custom connector → nome + URL https://.../mcp.
  • Claude Code (CLI):
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; 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).
  • 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