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://api.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://api.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://api.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://api.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://api.docs.topsort.com/mcp"
      }
    }
  }
}

Windsurf Editor

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

Continue

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

Cline

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

Solução de Problemas

Problemas de Conexão

  • Verifique se a URL está correta: https://api.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

Precisa de ajuda com sua integração Topsort?

Fale conosco, a equipe de engenharia de integrações.Entre em contato através do seu canal de mensagens dedicado ou em support@topsort.com.Se você ainda não é cliente, agende uma demo com nossa equipe de vendas.