# Configure o servidor MCP da Getnet

A documentação da Getnet inclui um servidor Model Context Protocol (MCP). Com seu assistente de IA conectado, ele pode buscar e ler cada página deste site, guias e referência de API, sempre na versão publicada em vez do que lembra do treinamento. Não é preciso conta nem cadastro.

<Callout type="info">
  **Somente leitura, limitado à documentação**

  O servidor MCP busca e lê a **documentação**: guias de produto, passos de integração e a referência de cada API da Getnet. Ele não chama as APIs da Getnet nem vê os dados do seu estabelecimento. Para fazer requisições reais, use suas credenciais de sandbox de [Chaves de API](/pt/articles/api-keys).
</Callout>

## O que você ganha

<CardGroup cols={2}>
  <Card title="Encontre a página certa" icon="search">
    Pergunte em linguagem natural e chegue ao guia ou endpoint que responde, em Global API, Web Checkout, App2App, Integrated POS e mais.
  </Card>

  <Card title="Leia endpoints completos" icon="braces">
    Consulte parâmetros, schemas de requisição e resposta e exemplos direto da referência de API.
  </Card>

  <Card title="Respostas no seu idioma" icon="languages">
    Busque em páginas em inglês, espanhol ou português, ou limite a busca a um deles.
  </Card>

  <Card title="Sempre atualizado" icon="refresh-cw">
    Cada resposta é lida da documentação como está publicada agora.
  </Card>
</CardGroup>

## Configuração rápida

O servidor MCP da Getnet fica em:

```
https://getnet.writedocs.io/mcp
```

Escolha sua ferramenta. Não é preciso autenticação.

<Tabs>
  <Tab title="Claude Code">

  Execute:

  ```bash
  claude mcp add --transport http getnet https://getnet.writedocs.io/mcp
  ```

  </Tab>

  <Tab title="Claude Desktop">

  Vá em **Settings → Connectors → Add custom connector** e informe:

  - **Nome:** `Getnet`
  - **URL:** `https://getnet.writedocs.io/mcp`

  </Tab>

  <Tab title="Cursor">

  Adicione ao `mcp.json` do projeto ou global:

  ```json
  {
    "mcpServers": {
      "getnet": {
        "url": "https://getnet.writedocs.io/mcp"
      }
    }
  }
  ```

  </Tab>

  <Tab title="VS Code">

  Adicione a `.vscode/mcp.json`:

  ```json
  {
    "servers": {
      "getnet": {
        "type": "http",
        "url": "https://getnet.writedocs.io/mcp"
      }
    }
  }
  ```

  </Tab>

  <Tab title="Windsurf">

  Adicione a `~/.codeium/windsurf/mcp_config.json`:

  ```json
  {
    "mcpServers": {
      "getnet": {
        "serverUrl": "https://getnet.writedocs.io/mcp"
      }
    }
  }
  ```

  </Tab>
</Tabs>

Reinicie o editor ou abra um chat novo e confirme a conexão perguntando algo que só esta documentação saberia, como *"Qual endpoint cria um link de pagamento na Payment Link API?"*

<Callout type="tip">
  **Conexão em um clique**

  O menu contextual de cada página (no canto superior direito) também tem **Copy MCP server URL**, **Connect to Cursor** e **Connect to VS Code**.
</Callout>

## Ferramentas disponíveis

| Ferramenta | O que faz |
| :--- | :--- |
| `list_docs` | Lista cada página da documentação com título, URL e descrição. |
| `search_docs` | Encontra as páginas que melhor respondem a uma pergunta. Pode ser limitada a um idioma (`en`, `es` ou `pt`). |
| `get_doc` | Retorna o conteúdo completo de uma página em Markdown, incluindo parâmetros e schemas de um endpoint. Aceita um caminho ou URL, ou vários. |

## Solução de problemas

<Accordion title="O servidor não aparece na minha lista de ferramentas">
  Confira se o JSON da configuração é válido (sem vírgulas sobrando, todas as chaves fechadas) e reinicie o editor ou abra uma sessão nova.
</Accordion>

<Accordion title="As respostas parecem desatualizadas">
  Abra uma conversa nova. Os resultados do MCP refletem a documentação publicada mais recente, mas um chat longo pode continuar raciocinando com o que leu antes.
</Accordion>

<Accordion title="As respostas vêm em outro idioma">
  Diga o idioma na pergunta, por exemplo *"responda com a documentação em português"*. Seu assistente pode passar isso ao `search_docs` como filtro de idioma.
</Accordion>

## Obtenha respostas melhores

Faça perguntas específicas sobre um produto em vez de perguntas amplas:

- Menos útil: "Como a Getnet funciona?"
- Mais útil: "Quais campos a Global API exige para um pagamento no crédito em 3 parcelas?"

## Próximos passos

- Novo na Getnet? Comece por [Escolha sua integração](/pt/docs/general/getnet-solutions).
- Pronto para construir? Pegue suas [Chaves de API](/pt/articles/api-keys) e siga o [quickstart da Global API](/pt/global-api/sep-api/first-steps-api/quickstart-api).