# Conectar assistentes de IA à documentação

Conectar um assistente de IA ao servidor [MCP](https://modelcontextprotocol.io) do Ripple Docs
permite que ele pesquise nesta documentação e leia as páginas atuais (referência da API,
exemplos de payload e comportamento específico de cada release) antes de responder. O servidor
cobre todos os produtos em `docs.ripple.com`, incluindo o Payments Direct,
e não exige autenticação:

```text
https://docs.ripple.com/mcp
```

## Claude Code

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

## Cursor

Abra a paleta de comandos (**Cmd+Shift+P** ou **Ctrl+Shift+P** no Windows e no
Linux), selecione **Open MCP settings**, depois **Add custom MCP**, e adicione o
servidor ao `mcp.json`:

```json
{
  "mcpServers": {
    "ripple-docs": {
      "url": "https://docs.ripple.com/mcp"
    }
  }
}
```

## VS Code

Adicione o servidor ao `.vscode/mcp.json` do seu workspace:

```json
{
  "servers": {
    "ripple-docs": {
      "type": "http",
      "url": "https://docs.ripple.com/mcp"
    }
  }
}
```

## Outros clientes

A maioria dos clientes MCP aceita a mesma URL. Consulte a documentação da sua ferramenta para saber como
registrar um servidor MCP remoto por HTTP. Se o cliente oferecer a opção, adicione o
servidor como um servidor MCP HTTP simples, e não como um conector autorizado.

## Solução de problemas

**O seu cliente pede para você entrar.** O servidor não precisa de credenciais, portanto dispense
a solicitação. Os clientes que exigem login por OAuth antes de listar as ferramentas,
incluindo os conectores personalizados do claude.ai, não conseguem se conectar. Use o Claude Code,
o Cursor ou o VS Code.

**O seu cliente lista apenas `authenticate` e `complete_authentication`.** Elas
pertencem à camada de autorização do próprio cliente, não a este servidor. Uma
conexão funcional expõe `search`, `list-apis`, `get-endpoints`, `get-endpoint-info`,
`get-security-schemes` e `get-full-api-description`.

**Verifique o servidor diretamente.** Isto retorna `"name": "Ripple Docs MCP server"`
sem credenciais. Os dois tipos de `Accept` são obrigatórios; sem eles, o servidor
responde `406 Not Acceptable`.

```sh
curl -sS -X POST https://docs.ripple.com/mcp \
  -H 'Content-Type: application/json' \
  -H 'Accept: application/json, text/event-stream' \
  -d '{"jsonrpc":"2.0","id":1,"method":"initialize","params":{"protocolVersion":"2025-03-26","capabilities":{},"clientInfo":{"name":"probe","version":"1.0"}}}'
```

## Context7

Esta documentação também é indexada pelo [Context7](https://context7.com), que
fornece a documentação da versão atual às ferramentas com a integração Context7. Adicione o
[servidor MCP do Context7](https://github.com/upstash/context7) à sua ferramenta e depois
referencie o ID de biblioteca `/websites/ripple_products_payments-direct-2` no seu
prompt, ou veja a [entrada no Context7](https://context7.com/websites/ripple_products_payments-direct-2).

As duas integrações são visões somente leitura da documentação pública. Elas não
dão acesso à sua conta do Payments Direct, aos seus pagamentos nem a quaisquer
dados de clientes, e não é possível executar operações da API por meio delas.