Pular para o conteúdo principal
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. 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 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.
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:
mcp.json
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:
Endereço
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:
mcp.json
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. O cliente precisa de suporte a servidor remoto por Streamable HTTP e a cabeçalho de requisição personalizado.

Problemas comuns

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

Ferramentas

O que cada ferramenta faz, com parâmetros, cuidados e erros.

Conexões autorizadas

Veja e revogue as conexões feitas pelo login.