# Servidor MCP da documentação

> Ligue o Claude, o ChatGPT, o Cursor ou o VS Code à documentação da NexTags: a IA busca e lê as duas centrais e a referência da API sozinha.

Endereço: https://docs.nextags.com.br/ia/servidor-mcp/
Tipo: Guia

Atualizado em: 26/10/2026

O servidor MCP da documentação deixa a sua IA consultar a NexTags sozinha. Com ele ligado, o Claude, o ChatGPT ou o seu editor de código buscam nas duas centrais, leem a página certa e respondem citando o link, sem você colar nada na conversa.

```text
https://docs.nextags.com.br/mcp
```

O servidor só lê a documentação pública da [Central de Ajuda](https://help.nextags.com.br/) e dos Desenvolvedores. Ele não pede login nem chave, não acessa nenhuma conta da NexTags e não guarda o que você pergunta. Para a IA operar a sua conta (criar contatos, enviar fluxos), use a [API](https://docs.nextags.com.br/comecar/visao-geral/) no seu sistema.

## O que a IA consegue fazer

| Ferramenta | O que faz |
|---|---|
| `search` | Busca nas páginas publicadas das duas centrais e devolve as mais próximas, com o título, o link e o resumo. |
| `fetch` | Lê uma página inteira em Markdown, pelo link que a busca devolveu. |
| `listar_endpoints` | Lista os endpoints da API, com o método, o caminho e o título, por grupo. |
| `detalhar_endpoint` | Devolve tudo de um endpoint: parâmetros, corpo, respostas e o exemplo em cURL. Aceita `POST /contacts`, o operationId ou o título, como "Criar contato". |

Todas as ferramentas são só de leitura. O servidor também oferece, como recursos, o [llms.txt](https://docs.nextags.com.br/llms.txt) das duas centrais e o [contrato OpenAPI](https://docs.nextags.com.br/openapi.json), e quatro pedidos prontos: escolher o caminho de uma integração, escrever uma integração com a API, mapear um webhook de entrada e revisar um código que chama a API. São os mesmos de [Prompts prontos](https://docs.nextags.com.br/ia/prompts-prontos/).

> **Quando a central muda:**
> O servidor lê o que está publicado. Quando uma página muda ou entra uma página nova, a IA já encontra a versão nova.

## Passo a passo

### Passo 1: Conecte no Claude (site e aplicativo)

Nos planos individuais, abra **Configurações** › **Conectores**, clique em **Adicionar conector personalizado**, dê um nome, como "NexTags", e cole o endereço:

```text
https://docs.nextags.com.br/mcp
```

Deixe a autenticação em branco e clique em **Adicionar**. Numa conversa, ligue o conector pelo botão **+** › **Conectores**. Nos planos Team e Enterprise, quem é dono da organização adiciona o conector em **Configurações de administrador** › **Conectores**, e cada pessoa conecta o seu. Passo a passo da Anthropic: [conectores personalizados com MCP remoto](https://support.claude.com/en/articles/11175166-get-started-with-custom-connectors-using-remote-mcp).

### Passo 2: Conecte no ChatGPT

No ChatGPT, servidores MCP próprios entram pelo **modo desenvolvedor** (Developer mode), nos planos em que a OpenAI libera esse modo. Ative o modo desenvolvedor nas configurações, crie um app novo com o endereço abaixo, sem autenticação, e escolha esse app na conversa. Os nomes dos menus mudam com frequência: siga o [artigo da OpenAI](https://help.openai.com/en/articles/12584461-developer-mode-apps-and-full-mcp-connectors-in-chatgpt-beta).

```text
https://docs.nextags.com.br/mcp
```

### Passo 3: Conecte no Claude Code

No terminal, um comando só:

```bash
claude mcp add --transport http nextags-docs https://docs.nextags.com.br/mcp
```

Para conferir, rode `claude mcp list` ou, dentro do Claude Code, `/mcp`.

### Passo 4: Conecte no Cursor ou no VS Code

No Cursor, acrescente o servidor ao `mcp.json` (em **Settings** › **MCP**, ou no arquivo `.cursor/mcp.json` do projeto). No VS Code, crie o arquivo `.vscode/mcp.json` no projeto.

**Configuração do servidor**

```json Cursor
{
  "mcpServers": {
    "nextags-docs": { "url": "https://docs.nextags.com.br/mcp" }
  }
}
```
```json VS Code
{
  "servers": {
    "nextags-docs": { "type": "http", "url": "https://docs.nextags.com.br/mcp" }
  }
}
```

## Pronto: como conferir

Pergunte algo que só a documentação da NexTags responde:

```text
Usando a documentação da NexTags, como eu respondo automaticamente quem comenta num post do Instagram?
```

A IA chama a busca, lê a página e responde com o passo a passo e o link (no exemplo, [Responder comentários do Instagram e chamar no Direct](https://help.nextags.com.br/tutoriais/instagram-e-facebook/comentario-para-direct/)). Na conversa, aparece o nome da ferramenta que ela usou.

## Se não funcionou

### A IA respondeu sem usar o servidor

Ligue o conector na conversa (no Claude, pelo **+** › **Conectores**; no ChatGPT, escolhendo o app) e peça de novo, dizendo "usando a documentação da NexTags".

### O ChatGPT não mostra o modo desenvolvedor

O modo desenvolvedor depende do plano e, nas contas de empresa, de o administrador liberar. Confira no [artigo da OpenAI](https://help.openai.com/en/articles/12584461-developer-mode-apps-and-full-mcp-connectors-in-chatgpt-beta) quais planos têm o recurso.

### O cliente pede login ou chave

O servidor não usa autenticação. Na tela de adicionar, deixe os campos de OAuth e de chave em branco, ou escolha "sem autenticação".

### Abri o endereço no navegador e apareceu "Method Not Allowed"

É o esperado: o endereço só responde a um cliente MCP. Use-o na configuração do Claude, do ChatGPT ou do editor.

### Apareceu "muitas chamadas seguidas"

Cada endereço de internet pode fazer até 120 chamadas por minuto ao servidor. Espere um minuto e peça de novo.

### Faça com a IA

Cole este pedido no ChatGPT ou no Claude:

```text
Conectei o servidor MCP da documentação da NexTags (https://docs.nextags.com.br/mcp). Leia esta página: https://docs.nextags.com.br/ia/servidor-mcp.md

Usando as ferramentas do servidor, me diga [a sua dúvida, por exemplo: como mando uma mensagem de WhatsApp quando uma compra é aprovada na Hotmart], com o passo a passo e os links das páginas.
```