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

> ## Agent Instructions
> Documentação oficial da sinnu, gateway de pagamento brasileiro: Pix e cartão de crédito. O índice de todas as páginas está em https://docs.sinnu.com.br/llms.txt.
> A API (https://api.sinnu.com.br) e o checkout (https://pay.sinnu.com.br) documentados são de produção. Não há ambiente público de testes: cada chamada cria ou altera dados reais.
> A chave secreta sk_live_ fica só no servidor. O navegador recebe apenas o slug do link ou a URL do checkout.
> Unidades: amountCents do link e os valores de /api/transactions/ estão em centavos (inteiro). data.amount do webhook e amount das transações de um link estão em reais. Compare na mesma unidade.
> Status: a API de transações usa approved; o corpo do webhook usa paid; o evento é transaction.approved.
> Libere o pedido só pelo webhook assinado (X-Sinnu-Signature, validado sobre o corpo cru com constructEvent({ payload, signature, secret })) e confirme com transactions.get. Nunca pelo evento completed do Sinnu Elements nem pelos parâmetros da URL de retorno.
> Estorno é sempre do valor total. Não invente métodos, campos ou eventos: confira na referência do SDK e da API.

# Conecte o Cursor, o VS Code e outros clientes

> Adicione o servidor MCP da sinnu no Cursor ou no VS Code só com o endereço e autorize pelo login, ou use a chave de API num cliente sem login.

O Cursor e o VS Code conectam pelo login da sinnu: a configuração leva só o endereço do servidor, sem cabeçalho, e a conexão é autorizada no painel. Para isso, você precisa do papel de Titular ou Administrador da empresa no [painel sinnu](https://app.sinnu.com.br).

Nos dois, a autorização é a mesma: o navegador abre a página de autorização da sinnu, no painel (`app.sinnu.com.br`). Entre, se precisar, e escolha a empresa e o nível de acesso: **Somente leitura**, para o editor só consultar, ou **Leitura e escrita**, para ele também criar e alterar links e clientes. Veja o que cada [nível](https://docs.sinnu.com.br/servidor-mcp/visao-geral.md#escolha-o-nível-de-acesso) libera. Confirme com o código enviado ao seu e-mail, quando o painel pedir, e clique em **Autorizar**. Depois, o navegador volta ao editor.

> [!WARNING]
>
> Com **Leitura e escrita**, o editor pode criar e alterar links e clientes na conta da sua empresa. Leia o que ele vai fazer antes de aprovar uma escrita e aprove as ferramentas de escrita uma a uma, sem a opção de sempre permitir. Se ele só vai consultar, escolha **Somente leitura**.

## Cursor

Grave a configuração em `~/.cursor/mcp.json`, para todos os projetos, ou em `.cursor/mcp.json`, só para um projeto:

```json mcp.json theme={null}
{
  "mcpServers": {
    "sinnu": {
      "url": "https://mcp.sinnu.com.br/mcp"
    }
  }
}
```

Não acrescente `headers` nem `auth`: o Cursor se registra sozinho no servidor de autorização da sinnu e guarda o login. Como o arquivo não leva credencial, a configuração do projeto pode ir para o controle de versão, e cada pessoa autoriza com o próprio login.

Abra **Customize**, na barra lateral do Cursor, e confira que o servidor `sinnu` está ligado. Quando o Cursor pedir para entrar no servidor, conclua a autorização no navegador.

O Cursor renova o acesso sozinho enquanto a conexão vale.

## VS Code

**1. Adicione o servidor**

Na paleta de comandos, rode **MCP: Add Server** e escolha **HTTP (HTTP or Server-Sent Events)**.

**2. Informe o endereço e o nome**

Informe o endereço, sem parâmetros:

```text Endereço theme={null}
https://mcp.sinnu.com.br/mcp
```

Use `sinnu` como identificador do servidor e escolha onde guardar a configuração.

**3. Autentique o servidor**

Quando o VS Code pedir para autenticar o servidor `sinnu`, aceite: o navegador abre a página de autorização da sinnu. Se o pedido não aparecer, use **Authenticate** nas ações do servidor.

Se você editar a configuração direto no `mcp.json` do VS Code, a entrada leva só o tipo e o endereço:

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

Não acrescente `headers` nem `oauth`: o VS Code se registra sozinho no servidor de autorização da sinnu.

## Outro cliente MCP

O login aceita só os assistentes que têm guia nesta documentação: Claude, Claude Code, ChatGPT, Cursor e VS Code. Outro cliente é recusado na autorização.

Para um cliente fora da lista, use a chave de API no cabeçalho `Authorization`, como em [Conecte com a chave de API](https://docs.sinnu.com.br/servidor-mcp/visao-geral.md#conecte-com-a-chave-de-api). O cliente precisa de suporte a servidor remoto por Streamable HTTP e a cabeçalho de requisição personalizado.

## Problemas comuns

> [accordion] O navegador não abre
>
> Procure no editor o endereço da autorização e abra-o no navegador. Conclua a autorização em até 10 minutos, no mesmo navegador: o pedido vale só nele.

> [accordion] A página da sinnu diz que o assistente não foi reconhecido
>
> Confira se a configuração tem só o endereço, sem `auth`, `oauth` nem ID de cliente. Remova o servidor, adicione de novo e autorize outra vez.

> [accordion] O editor pede para entrar de novo
>
> A conexão terminou: alguém a revogou no painel, ela ficou 30 dias sem uso ou quem autorizou deixou de ser Titular ou Administrador da empresa. Entre e autorize de novo.

> [accordion] As ferramentas de escrita não aparecem
>
> A conexão foi autorizada no nível **Somente leitura**, e o editor vê só as ferramentas de consulta. Confira o nível em [Conexões autorizadas](https://docs.sinnu.com.br/servidor-mcp/conexoes-autorizadas.md). O nível não muda depois da autorização: para o editor criar e alterar links e clientes, revogue a conexão, entre de novo pelo editor e autorize com **Leitura e escrita**.

Os outros motivos de recusa na autorização estão em [Se a autorização falhar](https://docs.sinnu.com.br/servidor-mcp/visao-geral.md#se-a-autorização-falhar).

> [card] [Ferramentas](https://docs.sinnu.com.br/servidor-mcp/ferramentas.md)
>
> O que cada ferramenta faz, com parâmetros, cuidados e erros.

> [card] [Conexões autorizadas](https://docs.sinnu.com.br/servidor-mcp/conexoes-autorizadas.md)
>
> Veja e revogue as conexões feitas pelo login.


This documentation is built and hosted on [Mintlify](https://mintlify.com), a developer documentation platform.