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

# Conexões autorizadas

> Veja e revogue as conexões que assistentes de IA têm com a sua empresa pelo login, troque o nível de acesso e saiba quando uma conexão termina sozinha.

Cada vez que alguém autoriza um assistente pelo login, a sinnu cria uma conexão entre aquele assistente e a empresa escolhida. As conexões ativas ficam listadas no painel, onde cada uma pode ser revogada.

A chave de API não aparece nesta lista: ela fica em **Desenvolvedor > Chave de API** e é revogada lá.

## Veja as conexões

No [painel](https://app.sinnu.com.br), abra **Desenvolvedor > MCP**. O cartão **Conexões autorizadas** lista as conexões ativas da empresa. Só Titular e Administrador da empresa veem a lista e revogam conexões.

Cada conexão mostra:

* o assistente, como Claude ou ChatGPT;
* o endereço para onde a autorização voltou, como `claude.ai`;
* o que a conexão acessa, escopo por escopo, como **Links (leitura)**;
* o nível de acesso: **Somente leitura** ou **Leitura e escrita**;
* quem autorizou;
* quando foi criada e quando foi usada pela última vez;
* quando expira, se não for usada até lá.

As chamadas de uma conexão são feitas na empresa da conexão, em nome de quem a autorizou. Com **Leitura e escrita**, o assistente pode criar e alterar links de pagamento 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.

## Revogue uma conexão

**1. Escolha a conexão**

Em **Conexões autorizadas**, clique em **Revogar** na conexão que quer encerrar.

**2. Confirme com o código**

Confirme com o código enviado ao seu e-mail, quando o painel pedir.

A API passa a recusar a conexão revogada na próxima chamada de ferramenta, e o assistente pede login de novo. Por até 5 minutos, o assistente ainda pode exibir a lista de ferramentas, sem acesso aos dados.

Revogar uma conexão não afeta as chaves de API nem as outras conexões.

Remover o servidor no assistente nem sempre revoga a conexão na sinnu. Para encerrar o acesso, revogue no painel.

## Troque o nível de uma conexão

O nível é escolhido na autorização e não muda depois: o painel não edita uma conexão. Para trocar de **Somente leitura** para **Leitura e escrita**, ou o contrário:

**1. Revogue a conexão atual**

Em **Conexões autorizadas**, revogue a conexão, como em [Revogue uma conexão](#revogue-uma-conexão).

**2. Conecte de novo pelo assistente**

Quando o assistente pedir login, autorize de novo e escolha o outro nível. A nova autorização vira uma conexão nova na lista.

Cada autorização cria uma conexão própria. Se você autorizar de novo sem revogar a anterior, as duas podem ficar na lista até a anterior ser revogada ou expirar.

## Quando a conexão termina sozinha

* **Depois de 30 dias sem uso.** Enquanto a conexão é usada, o assistente renova o acesso a cada hora. Sem uso por 30 dias, ela expira.
* **Quando quem autorizou perde o acesso.** Se essa pessoa deixa de ser membro ativo da empresa, perde o papel de Titular ou Administrador ou tem a conta desativada, a conexão é encerrada de vez na próxima chamada. Para voltar a conectar, um Titular ou Administrador autoriza de novo.

Em todos os casos, o assistente pede login de novo, e a conexão some da lista.

## Aviso por e-mail

A cada nova conexão autorizada, os Titulares da empresa recebem um e-mail com o assistente, a empresa, quem autorizou, o nível de acesso e a data. Trocar de nível também gera o aviso, porque cria uma conexão nova. Se você não reconhece a conexão, revogue-a em **Conexões autorizadas**.

## Boas práticas

* **Autorize só o que você pediu.** Uma autorização legítima começa no assistente, na mesma hora. Se alguém te mandou um link de autorização da sinnu, cancele.
* **Use o menor nível.** Autorize **Leitura e escrita** só quando o assistente precisa criar ou alterar links e clientes. Para consultar, **Somente leitura** basta.
* **Revise a lista.** Revogue as conexões que você não reconhece ou não usa mais, e as de **Leitura e escrita** que não precisam mais escrever.
* **Confira o endereço de retorno.** Ele mostra para onde a autorização voltou: o serviço do assistente ou o seu próprio computador, no caso de um assistente no terminal ou no editor.

> [card] [Servidor MCP](https://docs.sinnu.com.br/servidor-mcp/visao-geral.md)
>
> Login, chave de API, escopos e segurança.

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


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