Pular para o conteúdo principal
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.
  • O papel de Titular ou Administrador da empresa no painel sinnu. 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:
Endereço
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.

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.

"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 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:
Pedido
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.
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, 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:
Terminal
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. 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.

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.

Problemas comuns

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

Ferramentas

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

Conexões autorizadas

Veja e revogue as conexões feitas pelo login.