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

# Servidor MCP

> Integre nosso servidor MCP com seus agentes para se tornar produtivo rapidamente

export const IntegrationsCard1APt = () => {
  return <>
      <style>{`
        .integrations-card-1a-pt {
          display: flex;
          flex-direction: column;
          background-color: #f0f2f4;
          border: 1px solid rgba(0, 0, 0, 0.08);
          border-radius: 12px;
          padding: 1.25rem 1.5rem;
          gap: 0.25rem;
          color: #25253b;
          box-shadow: 0 1px 3px rgba(0, 0, 0, 0.02);
          transition: box-shadow 0.2s ease, border-color 0.2s ease, transform 0.2s ease;
          margin-top: 2rem;
        }

        .integrations-card-1a-pt:hover {
          box-shadow: 0 4px 12px rgba(0, 0, 0, 0.06);
          border-color: rgba(0, 0, 0, 0.12);
        }

        .dark .integrations-card-1a-pt {
          background-color: #25253b;
          color: #f6f8fa;
          border-color: rgba(255, 255, 255, 0.08);
          box-shadow: 0 1px 3px rgba(0, 0, 0, 0.1);
        }

        .dark .integrations-card-1a-pt:hover {
          box-shadow: 0 4px 12px rgba(0, 0, 0, 0.2);
          border-color: rgba(255, 255, 255, 0.12);
        }

        .integrations-card-1a-pt-avatar-row {
          display: flex;
          margin-left: 14px;
          flex-wrap: wrap;
        }

        .integrations-card-1a-pt-avatar {
          width: 44px;
          height: 44px;
          border-radius: 50%;
          border: 2px solid #f0f2f4;
          margin-left: -14px;
          object-fit: cover;
          box-shadow: 0 2px 6px rgba(0, 0, 0, 0.08);
          pointer-events: none;
          cursor: default;
        }

        .dark .integrations-card-1a-pt-avatar {
          border-color: #25253b;
          box-shadow: 0 2px 8px rgba(0, 0, 0, 0.2);
        }

        .integrations-card-1a-pt h2 {
          margin: 0;
          line-height: 1.25;
          font-size: clamp(1.25rem, calc(0.875rem + 1.25vw), 1.75rem);
          font-weight: 700;
          letter-spacing: -0.025em;
          color: #111827;
        }

        .dark .integrations-card-1a-pt h2 {
          color: #f9fafb;
        }

        .integrations-card-1a-pt-subtitle {
          font-size: 0.9375rem;
          font-weight: 500;
          line-height: 1.5;
          color: #4b5563;
          margin: 0;
        }

        .dark .integrations-card-1a-pt-subtitle {
          color: #d1d5db;
        }

        .integrations-card-1a-pt p {
          margin: 0;
          line-height: 1.5;
          font-size: 0.875rem;
          color: #374151;
        }

        .dark .integrations-card-1a-pt p {
          color: #d1d5db;
        }

        .integrations-card-1a-pt a {
          color: #0500ff;
          text-decoration: none;
          font-weight: 500;
          transition: color 0.15s ease;
        }

        .integrations-card-1a-pt a:hover {
          color: #0400cc;
        }

        .dark .integrations-card-1a-pt a {
          color: #8280ff;
        }

        .dark .integrations-card-1a-pt a:hover {
          color: #a19fff;
        }

        @media (max-width: 640px) {
          .integrations-card-1a-pt-avatar {
            width: 38px;
            height: 38px;
            margin-left: -12px;
          }

          .integrations-card-1a-pt-avatar-row {
            margin-left: 12px;
          }
        }

        @media (min-width: 1280px) {
          .integrations-card-1a-pt p {
            font-size: 0.6875rem;
            line-height: 1.4;
            letter-spacing: -0.01em;
          }

          .integrations-card-1a-pt h2 {
            font-size: clamp(1rem, calc(0.75rem + 1vw), 1.25rem);
          }

          .integrations-card-1a-pt-subtitle {
            font-size: 0.75rem;
          }
        }
      `}</style>
      <div className="integrations-card-1a-pt">
        <div className="integrations-card-1a-pt-avatar-row">
          <img src="/images/integration-team/agustin.webp" alt="" loading="lazy" className="integrations-card-1a-pt-avatar" />
          <img src="/images/integration-team/amelia.webp" alt="" loading="lazy" className="integrations-card-1a-pt-avatar" />
          <img src="/images/integration-team/bernardita.webp" alt="" loading="lazy" className="integrations-card-1a-pt-avatar" />
          <img src="/images/integration-team/borumy.webp" alt="" loading="lazy" className="integrations-card-1a-pt-avatar" />
          <img src="/images/integration-team/felipe.webp" alt="" loading="lazy" className="integrations-card-1a-pt-avatar" />
          <img src="/images/integration-team/gui.webp" alt="" loading="lazy" className="integrations-card-1a-pt-avatar" />
          <img src="/images/integration-team/javiera.webp" alt="" loading="lazy" className="integrations-card-1a-pt-avatar" />
          <img src="/images/integration-team/linn.webp" alt="" loading="lazy" className="integrations-card-1a-pt-avatar" />
          <img src="/images/integration-team/marcio.webp" alt="" loading="lazy" className="integrations-card-1a-pt-avatar" />
          <img src="/images/integration-team/mateus.webp" alt="" loading="lazy" className="integrations-card-1a-pt-avatar" />
          <img src="/images/integration-team/max.webp" alt="" loading="lazy" className="integrations-card-1a-pt-avatar" />
          <img src="/images/integration-team/rodrigo.webp" alt="" loading="lazy" className="integrations-card-1a-pt-avatar" />
        </div>

        <h2>Precisa de ajuda com sua integração Topsort?</h2>

        <p className="integrations-card-1a-pt-subtitle">
          Fale conosco, a equipe de engenharia de integrações.
        </p>

        <p>
          Entre em contato através do <strong>seu canal de mensagens dedicado</strong> ou em{" "}
          <a href="mailto:support@topsort.com">support@topsort.com</a>.
        </p>

        <p>
          Se você ainda não é cliente,{" "}
          <a href="https://www.topsort.com/book-a-demo">agende uma demo</a> com nossa
          equipe de vendas.
        </p>
      </div>
    </>;
};

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.

<Tip>
  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.
</Tip>

## 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

<CardGroup cols={2}>
  <Card title="VS Code & GitHub Copilot" icon="microsoft" href="#vs-code-com-github-copilot">
    Use MCP com GitHub Copilot no Visual Studio Code
  </Card>

  <Card title="ChatGPT" icon="message" href="#chatgpt">
    Conecte o ChatGPT para acessar a documentação do Topsort
  </Card>

  <Card title="Claude Desktop" icon="desktop" href="#claude-desktop">
    Configure o Claude Desktop para desenvolvimento local
  </Card>

  <Card title="Outros Clientes" icon="puzzle-piece" href="#outros-clientes-mcp">
    Cursor, Windsurf, Continue e mais
  </Card>
</CardGroup>

## 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

<Steps>
  <Step title="Abra as Configurações do VS Code">
    Pressione `Cmd+,` (Mac) ou `Ctrl+,` (Windows/Linux) para abrir as Configurações.
  </Step>

  <Step title="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**.
  </Step>

  <Step title="Adicione o Servidor MCP do Topsort">
    Clique em **Editar em settings.json** e adicione:

    ```json theme={null}
    {
      "github.copilot.chat.mcp.servers": {
        "topsort": {
          "type": "http",
          "url": "https://docs.topsort.com/mcp"
        }
      }
    }
    ```
  </Step>

  <Step title="Recarregue o VS Code">
    Pressione `Cmd+Shift+P` (Mac) ou `Ctrl+Shift+P` (Windows/Linux), digite "Developer: Reload Window" e pressione Enter.
  </Step>
</Steps>

## ChatGPT

ChatGPT suporta servidores MCP remotos para assinantes Plus e Team.

<Steps>
  <Step title="Abra as Configurações do ChatGPT">
    Navegue até [chat.openai.com](https://chat.openai.com) e clique no ícone do seu
    perfil, depois selecione **Settings**.
  </Step>

  <Step title="Acesse Conexões">
    Clique em **Connections** ou **Integrations** na barra lateral de configurações.
  </Step>

  <Step title="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`
  </Step>
</Steps>

## Claude Desktop

Claude Desktop fornece suporte MCP local abrangente.

### Pré-requisitos

* **Node.js** instalado no seu sistema (necessário para `mcp-remote`)

### Configuração

<Steps>
  <Step title="Abra as Configurações do Claude Desktop">
    * **macOS**: Clique em **Claude** na barra de menu → **Settings**
    * **Windows**: Clique em **File** → **Settings**
  </Step>

  <Step title="Navegue até a Aba Developer">
    Clique na aba **Developer** na barra lateral esquerda.
  </Step>

  <Step title="Edite a Configuração do MCP">
    Clique em **Edit Config** e adicione:

    ```json theme={null}
    {
      "mcpServers": {
        "topsort-docs": {
          "command": "npx",
          "args": [
            "mcp-remote",
            "https://docs.topsort.com/mcp"
          ]
        }
      }
    }
    ```
  </Step>

  <Step title="Reinicie o Claude Desktop">
    Salve a configuração e reinicie o Claude Desktop.
  </Step>
</Steps>

## Outros Clientes MCP

### Cursor

Adicione às suas configurações do Cursor:

```json theme={null}
{
  "mcp": {
    "servers": {
      "topsort": {
        "type": "http",
        "url": "https://docs.topsort.com/mcp"
      }
    }
  }
}
```

### Windsurf Editor

Configure em `~/.codeium/windsurf/mcp_config.json`:

```json theme={null}
{
  "mcpServers": {
    "topsort-docs": {
      "command": "npx",
      "args": [
        "mcp-remote",
        "https://docs.topsort.com/mcp"
      ]
    }
  }
}
```

<Note>
  Windsurf requer o pacote `mcp-remote` para se conectar a servidores MCP remotos. Certifique-se de que o Node.js está instalado no seu sistema.
</Note>

### Continue

Adicione a `~/.continue/config.json`:

```json theme={null}
{
  "mcpServers": {
    "topsort": {
      "transport": {
        "type": "http",
        "url": "https://docs.topsort.com/mcp"
      }
    }
  }
}
```

### Cline

Configure em `~/Documents/Cline/MCP/config.json`:

```json theme={null}
{
  "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](https://status.topsort.com) para quaisquer interrupções de serviço

<Warning>
  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.
</Warning>

## Saiba Mais

* [Documentação do Model Context Protocol](https://modelcontextprotocol.io)
* [Lista de Clientes MCP](https://modelcontextprotocol.io/clients)
* [Documentação da API Topsort](https://api.docs.topsort.com)

<IntegrationsCard1APt />