> ## 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 Claude ao servidor MCP

> Adicione o servidor MCP da sinnu como conector personalizado no Claude, entre com a sua conta e autorize a conexão no painel.

Ao terminar, o Claude consulta os links de pagamento, as transações e os clientes da sua empresa numa conversa, pela conexão que você autorizou no painel da sinnu. Se você autorizar o nível **Leitura e escrita**, ele também cria e altera links e clientes.

## Antes de começar

* **Um plano do Claude com conectores personalizados.** Eles existem nos planos Free (um conector), Pro, Max, Ultra, Team e Enterprise. Em Team e Enterprise, quem adiciona o conector é o Owner da organização: veja [Em uma organização](#em-uma-organização).
* **O papel de Titular ou Administrador** da empresa no [painel sinnu](https://app.sinnu.com.br). Só esses papéis autorizam a conexão.

Não é preciso criar chave de API nem informar cabeçalho: o Claude entra pelo login da sinnu.

A conexão com o servidor sai da nuvem do Claude, não do seu computador, na web, no desktop e no celular.

## Adicione o conector

Os passos e as imagens abaixo são do Claude na web.

**1. Abra a janela de conector personalizado**

Na página **Conectores** do Claude, a que tem as abas **Meus** e **Descobrir**, abra a janela **Adicionar conector personalizado**. Na interface em inglês, o caminho é **Customize > Connectors**, depois **+ Add** e **Add custom connector**.

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

Dê um nome ao conector, como `Sinnu MCP`: é o que aparece na lista de conectores. No endereço, informe:

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

![Janela Adicionar conector personalizado do Claude, com o nome Sinnu MCP, o endereço https://mcp.sinnu.com.br/mcp e os botões Cancelar e Continuar.](https://mintcdn.com/sinnu/jEiOLsL1SRJmKQfz/images/servidor-mcp/claude/01-nome-e-endereco.png?fit=max\&auto=format\&n=jEiOLsL1SRJmKQfz\&q=85\&s=c3e8a85662a5e75aef836b2f1880c2bb)

Nome e endereço do conector.

Use o endereço exatamente assim, sem parâmetros: o modo de acesso é escolhido na autorização.

Clique em **Continuar**.

**3. Mantenha as opções detectadas**

Em **Autenticação**, mantenha **Entrar agora**, que o Claude marca como **Detectado**: cada usuário entra pelo login da sinnu antes de usar o conector.

![Seção Autenticação da janela Adicionar conector personalizado do Claude. A opção Entrar agora está marcada, com o selo Detectado. Abaixo dela ficam as opções Fazer login quando necessário e Sem login.](https://mintcdn.com/sinnu/UuEKI797rqVEdQuM/images/servidor-mcp/claude/autenticacao.png?fit=max\&auto=format\&n=UuEKI797rqVEdQuM\&q=85\&s=79ba397c62e80cc90768cdb7fbb7ff64)

"Entrar agora", marcado como detectado.

Em **Cliente OAuth**, mantenha também a opção marcada como **Detectado** e não informe ID nem segredo de cliente. Não adicione cabeçalho de requisição.

Clique em **Adicionar**. Depois de adicionado, o Claude não deixa mudar a autenticação do conector: para trocar, é preciso remover e adicionar de novo.

**4. Conecte e entre na sinnu**

No conector, clique em **Conectar** (**Connect**, na interface em inglês). O Claude abre no navegador a página de autorização da sinnu, no painel. Se você não estiver logado, entre como de costume: ao terminar, o painel volta para a autorização.

**5. Autorize a conexão**

Confira que a página está em `app.sinnu.com.br`, que o assistente é o Claude e que o endereço de retorno é do Claude (`claude.ai` ou `claude.com`).

Escolha a empresa e o nível de acesso: **Somente leitura**, para o Claude 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**. O navegador volta ao Claude, com o conector conectado.

**6. Ligue o conector na conversa**

Numa conversa, use o botão **+**, no canto inferior esquerdo, abra **Connectors** e ligue o conector `Sinnu MCP`. Ele fica ligado naquela conversa.

Faça um pedido que use a conta:

```text Pedido theme={null}
Liste meus links de pagamento ativos.
```

**7. Aprove o uso das ferramentas**

O Claude pede aprovação antes de usar uma ferramenta. Use **Always allow** só para o que pode rodar sem supervisão, como as ferramentas de consulta.

Com **Leitura e escrita**, o Claude 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 **Always allow**.

## Em uma organização

Em um plano Team ou Enterprise, o Owner da organização adiciona o conector em **Organization settings > Connectors**, com **Add** e **Custom** e, se o Claude perguntar o tipo, **Web**. Use o mesmo nome, o mesmo endereço e as opções detectadas dos passos acima.

Depois, cada membro abre **Customize > Connectors**, encontra o conector com o selo **Custom**, clica em **Connect** e autoriza com a própria conta da sinnu.

> [!NOTE]
>
> Cada membro autoriza com o próprio login e escolhe o nível da própria conexão, e só quem é Titular ou Administrador da empresa na sinnu consegue autorizar. Cada autorização vira uma conexão própria em [Conexões autorizadas](https://docs.sinnu.com.br/servidor-mcp/conexoes-autorizadas.md), com o nome de quem autorizou e o nível.

## Claude Code

No terminal, adicione o servidor com o transporte HTTP, só com o endereço:

```bash Terminal theme={null}
claude mcp add --transport http sinnu https://mcp.sinnu.com.br/mcp
```

Depois, numa sessão do Claude Code, rode `/mcp`, escolha o servidor `sinnu` e siga a autenticação. O navegador abre a página de autorização da sinnu; se ele não abrir sozinho, copie o endereço que o Claude Code mostra e abra-o no navegador. Autorize como nos passos acima. No Claude Code, o endereço de retorno é o seu próprio computador (`localhost` ou `127.0.0.1`).

O Claude Code guarda o login e renova o acesso sozinho.

A opção `-s, --scope` define o escopo da configuração: `local` (o padrão), `user` ou `project`. O comando não leva credencial, então o escopo `project` grava só o endereço no arquivo do projeto, e cada pessoa autoriza com o próprio login.

| Comando | O que faz |
| - | - |
| `claude mcp list` | Lista os servidores configurados. |
| `claude mcp get sinnu` | Mostra os detalhes do servidor. |
| `claude mcp remove sinnu` | Remove o servidor. |
| `/mcp`, opção **Clear authentication** | Apaga o login guardado no Claude Code. |

Remover o servidor ou apagar o login no Claude Code não garante que a conexão seja revogada na sinnu. Para encerrar o acesso, revogue em [Conexões autorizadas](https://docs.sinnu.com.br/servidor-mcp/conexoes-autorizadas.md).

## Segurança

* **Autorize só o que você pediu.** Abra a autorização a partir do Claude. Se alguém te mandou um link de autorização da sinnu, cancele.
* **Escolha o menor nível.** Se o Claude só vai consultar, autorize **Somente leitura**.
* **Revise as escritas.** Criar link e cadastrar cliente não são idempotentes, e alterar sobrescreve o valor atual. Confira o que o Claude vai gravar antes de aprovar.
* **Trate textos de terceiros como dados.** Nomes e descrições que vêm de compradores são escritos por outras pessoas. Confira o que o Claude conclui a partir deles.
* **Revogue o que não usa.** Uma conexão que você não usa mais pode ser revogada no painel sem afetar as outras.

Veja também a [segurança do servidor](https://docs.sinnu.com.br/servidor-mcp/visao-geral.md#segurança).

## Problemas comuns

> [accordion] A página da sinnu diz que o pedido expirou ou não é deste navegador
>
> O pedido de autorização vale por 10 minutos e só no navegador em que foi aberto. Clique em **Conectar** de novo no Claude e conclua a autorização no navegador que ele abrir.

> [accordion] A página da sinnu diz que só Titular ou Administrador pode autorizar
>
> O seu papel na empresa não autoriza conexões. Peça a um Titular ou Administrador para conectar, ou para mudar o seu papel na equipe.

> [accordion] A conexão com assistentes ainda não está disponível para a sua empresa
>
> O login não está disponível para a sua empresa neste momento. Enquanto isso, um assistente que aceita cabeçalho de requisição pode usar a [chave de API](https://docs.sinnu.com.br/servidor-mcp/visao-geral.md#conecte-com-a-chave-de-api).

> [accordion] A página da sinnu diz que o assistente não foi reconhecido
>
> Confira as opções de **Autenticação** e de **Cliente OAuth** do conector: as duas devem ser as marcadas como **Detectado**, sem ID nem segredo de cliente. Como o Claude não deixa mudar a autenticação depois, remova o conector e adicione de novo.

> [accordion] O Claude pede para conectar 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. Clique em **Conectar** e autorize de novo.

> [accordion] As ferramentas de escrita não aparecem
>
> A conexão foi autorizada no nível **Somente leitura**, e o Claude 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 Claude criar e alterar links e clientes, revogue a conexão, clique em **Conectar** no Claude e autorize de novo com **Leitura e escrita**.

> [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.