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

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

Ao terminar, o ChatGPT 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

* **O ChatGPT na web, com servidores MCP personalizados liberados.** A opção depende do plano e, num workspace, das permissões definidas pelos administradores dele. Se ela não aparecer, confira a documentação do ChatGPT ou fale com quem administra o workspace.
* **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: o ChatGPT entra pelo login da sinnu.

## Adicione o servidor

Os rótulos abaixo são os da interface do ChatGPT em inglês.

**1. Abra os plugins**

Na web, abra **ChatGPT Plugins** (`chatgpt.com/plugins`), clique no botão **+** e escolha **Add custom MCP server**.

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

Dê um nome ao servidor, como `sinnu`, e, se quiser, uma descrição. Em **Connection**, informe o endereço em **Server URL**:

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

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

**3. Escolha OAuth**

Na autenticação, escolha **OAuth**. Se o ChatGPT oferecer formas de registrar o cliente, mantenha o registro automático (Dynamic Client Registration) e não informe ID nem segredo de cliente.

**4. Crie o plugin**

Leia o aviso de risco, confirme com **I understand and want to continue** e clique em **Create as a plugin**. Revise as ferramentas e as informações que o ChatGPT mostrar.

**5. Instale e entre na sinnu**

Instale o plugin. Quando o ChatGPT pedir para entrar, ele 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.

**6. Autorize a conexão**

Confira que a página está em `app.sinnu.com.br`, que o assistente é o ChatGPT e que o endereço de retorno é `chatgpt.com`.

Escolha a empresa e o nível de acesso: **Somente leitura**, para o ChatGPT 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 ChatGPT.

**7. Use na conversa**

Numa conversa, digite `@` e escolha o plugin da sinnu. Faça um pedido que use a conta:

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

Com **Leitura e escrita**, o ChatGPT pode criar e alterar links e clientes na conta da sua empresa. Quando ele pedir confirmação de uma escrita, leia o que ele vai fazer antes de aprovar e aprove as escritas uma a uma, sem a opção de sempre permitir.

## Segurança

* **Autorize só o que você pediu.** Abra a autorização a partir do ChatGPT. Se alguém te mandou um link de autorização da sinnu, cancele.
* **Escolha o menor nível.** Se o ChatGPT 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 ChatGPT 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 ChatGPT conclui a partir deles.
* **Revogue o que não usa.** Uma conexão que você não usa mais pode ser revogada em [Conexões autorizadas](https://docs.sinnu.com.br/servidor-mcp/conexoes-autorizadas.md) 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 opção de servidor MCP personalizado não aparece
>
> A opção depende do plano do ChatGPT e, num workspace, das permissões que os administradores liberaram. Confira a documentação do ChatGPT ou fale com quem administra o workspace.

> [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. Comece a conexão de novo pelo ChatGPT 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 cliente MCP 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] O ChatGPT 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 ChatGPT 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 ChatGPT criar e alterar links e clientes, revogue a conexão, entre de novo pelo ChatGPT e autorize 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.