Saltar para o conteúdo principal
O Model Context Protocol (MCP) é um padrão de código aberto para conectar aplicações de IA a sistemas externos. O Topsort fornece um servidor MCP através do Mintlify que dá aos assistentes de IA acesso direto à nossa documentação completa de API, permitindo que eles forneçam informações precisas e atualizadas sobre nossas APIs.
Pense no MCP como uma porta USB-C para aplicações de IA. Assim como o USB-C fornece uma maneira padronizada de conectar dispositivos, o MCP fornece uma maneira padronizada de conectar aplicações de IA a fontes de dados externas como nossa documentação de API.

O que Você Pode Fazer

Ao se conectar ao servidor MCP do Topsort, os assistentes de IA podem:
  • Acessar documentação completa da API - Consultar detalhes de endpoints, parâmetros, esquemas de solicitação/resposta e exemplos
  • Obter orientação precisa de integração - Receber exemplos de código e instruções de implementação atualizadas
  • Solucionar problemas mais rapidamente - Consultar rapidamente códigos de erro, limites de taxa e métodos de autenticação
  • Manter-se atualizado - Sempre acessar a documentação mais recente da API sem atualizações manuais

Início Rápido

Nosso servidor MCP está disponível em:
https://docs.topsort.com/mcp
O servidor MCP é publicamente acessível e não requer autenticação. No entanto, você precisará de chaves de API para realmente usar a API do Topsort em suas aplicações.

Guias de Integração

VS Code com GitHub Copilot

GitHub Copilot suporta servidores MCP tanto no agente de codificação quanto na interface de chat.

Pré-requisitos

  • VS Code versão 1.95.0 ou posterior
  • Extensão GitHub Copilot instalada e ativada
  • Extensão GitHub Copilot Chat instalada

Configuração

1

Abra as Configurações do VS Code

Pressione Cmd+, (Mac) ou Ctrl+, (Windows/Linux) para abrir as Configurações.
2

Navegue até a Configuração do MCP

Busque por “MCP” na barra de busca de configurações, ou navegue até Extensões > GitHub Copilot > MCP.
3

Adicione o Servidor MCP do Topsort

Clique em Editar em settings.json e adicione:
{
  "github.copilot.chat.mcp.servers": {
    "topsort": {
      "type": "http",
      "url": "https://docs.topsort.com/mcp"
    }
  }
}
4

Recarregue o VS Code

Pressione Cmd+Shift+P (Mac) ou Ctrl+Shift+P (Windows/Linux), digite “Developer: Reload Window” e pressione Enter.

ChatGPT

ChatGPT suporta servidores MCP remotos para assinantes Plus e Team.
1

Abra as Configurações do ChatGPT

Navegue até chat.openai.com e clique no ícone do seu perfil, depois selecione Settings.
2

Acesse Conexões

Clique em Connections ou Integrations na barra lateral de configurações.
3

Adicione Servidor MCP

Clique em Add Connection e digite: - Nome: Documentação da API Topsort
  • URL do Servidor: https://docs.topsort.com/mcp - Tipo de Transporte: http

Claude Desktop

Claude Desktop fornece suporte MCP local abrangente.
1

Abra as Configurações do Claude Desktop

  • macOS: Clique em Claude na barra de menu → Settings
  • Windows: Clique em FileSettings
2

Navegue até a Aba Developer

Clique na aba Developer na barra lateral esquerda.
3

Edite a Configuração do MCP

Clique em Edit Config e adicione:
{
  "mcpServers": {
    "topsort-api": {
      "type": "http",
      "url": "https://docs.topsort.com/mcp",
      "description": "Documentação da API Topsort"
    }
  }
}
4

Reinicie o Claude Desktop

Salve a configuração e reinicie o Claude Desktop.

Outros Clientes MCP

Cursor

Adicione às suas configurações do Cursor:
{
  "mcp": {
    "servers": {
      "topsort": {
        "type": "http",
        "url": "https://docs.topsort.com/mcp"
      }
    }
  }
}

Windsurf Editor

Configure em ~/.windsurf/mcp.json:
{
  "servers": {
    "topsort": {
      "type": "http",
      "url": "https://docs.topsort.com/mcp"
    }
  }
}

Continue

Adicione a ~/.continue/config.json:
{
  "mcpServers": {
    "topsort": {
      "transport": {
        "type": "http",
        "url": "https://docs.topsort.com/mcp"
      }
    }
  }
}

Cline

Configure em ~/Documents/Cline/MCP/config.json:
{
  "topsort": {
    "type": "http",
    "url": "https://docs.topsort.com/mcp"
  }
}

Solução de Problemas

Problemas de Conexão

  • Verifique se a URL está correta: https://docs.topsort.com/mcp
  • Verifique sua conexão com a internet
  • Reinicie sua aplicação cliente MCP
  • Revise os logs específicos do cliente para mensagens de erro

Servidor Não Respondendo

  • Verifique se o tipo de transporte está definido como http
  • Verifique se seu firewall ou VPN está bloqueando a conexão
  • Verifique nossa página de status para quaisquer interrupções de serviço
Embora o próprio servidor MCP não exija autenticação, você ainda precisará de chaves de API válidas para realmente usar a API do Topsort em suas aplicações. Nunca compartilhe suas chaves de API em conversas ou faça commit delas no controle de versão.

Saiba Mais