Conecte um assistente de IA à sua conta sinnu pelo login, autorizando a conexão no painel, ou com a chave de API da empresa.
O servidor MCP da sinnu expõe a API pública como ferramentas do Model Context Protocol (MCP). Conectado a ele, um assistente consulta links de pagamento, transações e clientes da sua empresa e, quando a conexão permite, cria e altera links e clientes.O servidor é uma camada fina e sem estado: cada chamada de ferramenta vira uma chamada à API pública. Quem decide o que a conexão pode fazer continua sendo a API.
O servidor atende em https://mcp.sinnu.com.br/mcp e usa a API de produção: o que o assistente cria ou altera vale na conta da sua empresa. Não há ambiente de testes.
Há duas formas de conectar um assistente:
Login
Chave de API
Como funciona
O assistente abre o navegador, você entra no painel e autoriza a conexão para uma empresa.
A chave sk_live_... vai no cabeçalho Authorization de cada requisição.
Acesso
O nível escolhido na autorização: Somente leitura ou Leitura e escrita.
Os escopos da chave, com ou sem escrita.
Assistentes
Claude, Claude Code, ChatGPT, Cursor e VS Code.
Qualquer cliente MCP que envie um cabeçalho de requisição personalizado.
Prefira o login: ninguém copia nem guarda uma credencial fixa, e cada conexão aparece no painel com quem a autorizou e o nível de acesso, e pode ser revogada sem afetar as outras. Use a chave para um cliente sem login ou para escolher os escopos um a um, em vez de um dos dois níveis do login.
Conecte com login
Você precisa ser Titular ou Administrador da empresa no painel sinnu e usar um dos assistentes da tabela acima.
Escolha o nível de acesso
Na autorização, você escolhe o que o assistente pode fazer na empresa:
Nível
Escopos da conexão
O que o assistente faz
Somente leitura
links:read, transactions:read e customers:read
Consulta links de pagamento, transações e clientes. Vê as 8 ferramentas de consulta.
Leitura e escrita
Os três de leitura, mais links:write e customers:write
Também cria e altera links de pagamento e clientes. Vê as 12 ferramentas: as 8 de consulta e as 4 de escrita.
A conexão recebe os escopos do nível escolhido, qualquer que seja o pedido do assistente. Nenhum dos dois níveis inclui Estorno, webhooks nem Carteira: o servidor não tem ferramenta que os use.
Com Leitura e escrita, o assistente pode criar e alterar links de pagamento 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 o assistente só vai consultar, escolha Somente leitura.
O nível não muda depois da autorização. Para trocar, revogue a conexão em Conexões autorizadas e conecte de novo pelo assistente, escolhendo o outro nível.
Passo a passo
1
Adicione o servidor no assistente
Informe o endereço do servidor, sem parâmetros e sem cabeçalho:
O assistente abre no navegador a página de autorização da sinnu, no painel (app.sinnu.com.br). Se você não estiver logado, entre como de costume: ao terminar, o painel volta para a autorização.
3
Autorize a conexão
Confira o nome do assistente e o endereço para onde o navegador volta depois de autorizar. Escolha a empresa e o nível de acesso (Somente leitura ou Leitura e escrita), confirme com o código enviado ao seu e-mail, quando o painel pedir, e clique em Autorizar.O pedido de autorização vale por 10 minutos e só no navegador em que foi aberto.
4
Confira a conexão
O navegador volta ao assistente, que passa a usar a conexão. Peça a ele a conta conectada: ele chama get_account_context, que devolve a empresa e os escopos da conexão. Com Leitura e escrita, os escopos incluem links:write e customers:write.
O login funciona só com os assistentes da tabela. Outro cliente MCP é recusado na autorização: para ele, use a chave de API.
Conecte com a chave de API
A chave é o caminho para um cliente MCP sem login e para quem quer escolher os escopos um a um. Você precisa de um cliente MCP com suporte a servidor remoto por Streamable HTTP e a cabeçalho de requisição personalizado.
1
Crie uma chave para o assistente
No painel, abra Desenvolvedor > Chave de API e use Nova chave. Escolha as permissões, confirme a criação com o código enviado por e-mail e copie a chave: ela não é exibida de novo.
As permissões de leitura na janela Nova chave de API.
Escolha as permissões pelo que o assistente vai fazer:
O assistente vai
Permissões
Só consultar
As de leitura bastam: Leitura (tudo), ou só as que ele vai usar entre Links — leitura, Transações — leitura e Clientes — leitura.
Criar ou alterar links e clientes
Ligue também Links — escrita e Clientes — escrita. Mantenha as de leitura: as ferramentas de alteração podem ler o registro antes de gravar.
Deixe Transações — estorno e Webhooks desligadas: o servidor MCP não tem ferramenta que as use. Carteira — leitura também não é usada por nenhuma ferramenta. Veja o escopo de cada ferramenta.
2
Configure o cliente MCP
Informe o endereço do servidor e envie a chave no cabeçalho Authorization. Muitos clientes aceitam uma configuração neste formato; os nomes dos campos variam, então confira a documentação do seu cliente.
Substitua sk_live_... pela chave. Se o cliente oferecer mais de uma forma de autenticação, escolha a opção sem login e informe a chave como cabeçalho de requisição.
3
Confira a conexão
Peça ao assistente a conta conectada. Ele chama get_account_context, que devolve a empresa, os escopos da chave e se a conexão é somente leitura.Para conferir sem o assistente, liste as ferramentas com cURL:
Metadados do recurso protegido (RFC 9728), sem autenticação: o endereço do servidor, o servidor de autorização e os escopos. O mesmo documento responde em /.well-known/oauth-protected-resource.
GET /healthz
200 com {"status":"ok"}, sem autenticação.
Autenticação
Toda requisição a /mcp leva uma credencial no cabeçalho Authorization: o token que o assistente recebe pelo login ou a chave sk_live_....
Header
Authorization: Bearer SUA_CREDENCIAL
Login
O login segue a autorização OAuth 2.1 da especificação MCP. O assistente conduz o fluxo sozinho; esta seção serve para entender o que acontece e investigar uma falha.
Sem credencial, o servidor responde 401. O cabeçalho WWW-Authenticate traz resource_metadata, com o endereço dos metadados do recurso, e scope, com os escopos do nível Somente leitura.
Os metadados do recurso apontam o servidor de autorização, https://auth.sinnu.com.br, que publica os dele em /.well-known/oauth-authorization-server.
O assistente se registra pelo registro dinâmico de cliente e abre a autorização no navegador, com PKCE (S256) e o parâmetro resource igual a https://mcp.sinnu.com.br/mcp.
Você entra no painel, escolhe a empresa e o nível e autoriza. A conexão recebe os escopos desse nível, mesmo que o assistente tenha pedido outros. O assistente troca o código recebido por um token de acesso, válido por 1 hora, e um token de renovação.
O assistente renova o token de acesso sozinho. A cada renovação, o token de renovação anterior deixa de valer, e reapresentar um token de renovação já usado encerra o acesso: o assistente pede login de novo.
Só Titular ou Administrador da empresa autoriza uma conexão. As chamadas da conexão são feitas na empresa escolhida, em nome de quem autorizou. O link de pagamento criado pela conexão sai sem Vendedor responsável, como o criado pela chave de API. Os Titulares da empresa recebem um e-mail a cada nova conexão autorizada, com o nível de acesso dela.A conexão vale enquanto o assistente a usa e expira depois de 30 dias sem uso. Ela termina na hora quando alguém a revoga no painel ou quando quem autorizou deixa de ser membro ativo da empresa, perde o papel de Titular ou Administrador ou tem a conta desativada. Veja Conexões autorizadas.O servidor MCP não repassa à API o token que recebe do assistente. Ele troca esse token, no servidor de autorização, por uma credencial aceita só pela API e válida pelo tempo que resta do token do assistente. O token do assistente, sozinho, não abre a API.
Chave de API
Com a chave, o cabeçalho leva Bearer e a chave sk_live_.... O servidor confere a chave na própria API e repassa essa mesma chave em cada chamada de ferramenta. Ele não tem usuário, senha nem credencial própria para a chave: sem ela, não lê nada.
Se a conexão falhar
As recusas da conexão voltam em JSON, com error e message.
HTTP
error
Confira
401
unauthorized
Nenhuma credencial foi enviada. Um assistente com login inicia a autorização a partir desta resposta.
401
invalid_token
O cabeçalho não segue Bearer <credencial>, ou a credencial é inválida, expirou ou foi revogada. Com login, o assistente renova o token ou pede login de novo.
400
invalid_query
O endereço aceita só o parâmetro readonly, uma vez, com true, 1, false ou 0.
413
payload_too_large
O corpo da requisição passa de 64 KiB.
429
rate_limited
Requisições ou credenciais recusadas demais em pouco tempo. Aguarde o intervalo de Retry-After, quando o cabeçalho vier.
503
temporarily_unavailable
O servidor não conseguiu validar a credencial agora. Tente de novo em instantes.
Uma requisição com várias mensagens JSON-RPC (lote) é recusada com 400: envie uma mensagem por requisição.
Se a autorização falhar
Na autorização pelo login, o painel explica o motivo da recusa:
Situação
O que fazer
O pedido expirou ou não é deste navegador.
Comece de novo pelo assistente e conclua a autorização em até 10 minutos, no navegador que ele abrir.
O pedido já foi respondido.
Volte ao assistente. Se ele não estiver conectado, conecte de novo.
Só Titular ou Administrador pode autorizar.
Peça a um Titular ou Administrador da empresa para autorizar, ou para mudar o seu papel na equipe.
A conexão com assistentes ainda não está disponível para a empresa.
O login não está disponível para a sua empresa neste momento. Enquanto isso, conecte com a chave de API.
O assistente não foi reconhecido.
O login aceita só os assistentes da tabela do início desta página. Confira a configuração do assistente pelo guia dele ou use a chave de API.
A autorização está indisponível ou deu erro.
Tente de novo em instantes, começando pelo assistente.
Escopos e ferramentas
A lista de ferramentas reflete o que a credencial permite: o nível de acesso escolhido no login ou os escopos da chave. Uma conexão sem escopo de escrita não enxerga as ferramentas de escrita. Isso evita que o assistente tente o que a API negaria; quem autoriza cada chamada continua sendo a API.
No login, a conexão recebe os escopos do nível escolhido. Somente leitura vê as 8 ferramentas de consulta; Leitura e escrita vê as 12 e já inclui os escopos de leitura que update_payment_link e update_customer também usam.
Escopo da chave
Com a chave, as ferramentas seguem os escopos dela. O escopo read cobre todos os escopos de leitura e nenhum de escrita. O escopo transactions:refund não libera nenhuma ferramenta: o servidor não faz estorno. Veja como escolher os escopos da chave.
Modo somente leitura
Com login, o que a conexão pode fazer vem do nível escolhido na autorização: no nível Somente leitura, ela não recebe escopo de escrita, e as ferramentas de escrita não aparecem. Use o endereço sem parâmetros: um endereço com parâmetro pode fazer a autorização falhar.Com a chave, acrescente ?readonly=true ao endereço para uma conexão que só consulta:
Endereço somente leitura
https://mcp.sinnu.com.br/mcp?readonly=true
Nesse modo o servidor oferece só as ferramentas de consulta (8, com uma chave que lê tudo), mesmo que a chave tenha escopos de escrita, e bloqueia qualquer chamada à API que não seja uma consulta. get_account_context devolve readOnly: true. Pelo login, com o endereço sem parâmetros, readOnly vem false nos dois níveis: o nível aparece nos escopos.O parâmetro aceita true ou 1 para ligar e false ou 0 para desligar. Outro valor, o parâmetro repetido ou qualquer outro parâmetro no endereço é recusado com 400: o servidor nunca abre uma conexão com escrita para quem pediu somente leitura de um jeito que ele não reconhece.
Segurança
A conexão dá ao assistente acesso aos dados da sua empresa. Trate-a como trataria um sistema com acesso à sua conta.
Autorize só o que você pediu. Abra a autorização a partir do assistente e confira que a página é do painel (app.sinnu.com.br), com o nome do assistente e o endereço de retorno que você espera. Se alguém te mandou um link de autorização, cancele.
Revogue o que não usa. As conexões feitas pelo login ficam em Conexões autorizadas, cada uma com quem a autorizou e o nível de acesso.
No login, escolha o menor nível. Para um assistente que só consulta, autorize Somente leitura.
Com a chave, use uma chave dedicada, com o menor escopo. Uma chave só para o assistente pode ser revogada sem afetar as outras integrações. Para um assistente que só consulta, combine uma chave de leitura com ?readonly=true.
Revise as escritas. Com Leitura e escrita no login, ou com uma chave com escopo de escrita, o assistente pode criar e alterar links e clientes. 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. Criar link e cadastrar cliente não são idempotentes, e alterar sobrescreve o valor atual.
Trate textos de terceiros como dados. Nomes, e-mails, descrições, observações e referências são escritos por compradores e por outras pessoas. O servidor orienta o modelo a não os seguir como instruções, mas essa orientação não substitui a sua revisão.
Cuide dos dados pessoais. O cadastro completo de um cliente, com documento e endereço, chega ao assistente quando ele consulta o cliente. Os dois níveis do login incluem customers:read; com a chave, conceda esse escopo só se o assistente precisar.
Se a credencial vazar, revogue. Revogue a conexão em Conexões autorizadas ou a chave em Chave de API. A API passa a recusar a credencial revogada, inclusive nas chamadas feitas pelo servidor MCP.
O servidor não tem banco de dados e não guarda credenciais entre requisições: mantém em memória só o hash da credencial recebida, para reaproveitar a validação por até 60 segundos com a chave e por até 5 minutos com o login, e não a escreve em log.
Limites atuais
O login funciona com Claude, Claude Code, ChatGPT, Cursor e VS Code. Outros clientes usam a chave de API.
No login, os escopos vêm em dois níveis fixos. Para escolher escopo por escopo, como escrita só em links, use a chave de API.
As ferramentas cobrem links de pagamento, transações e clientes. O servidor não faz estorno, não arquiva nem exclui link, não reativa link arquivado, não exclui cliente, não consulta o saldo da carteira nem saques e não gerencia webhooks.
A criação de link é só de valor fixo e pagamento avulso.
Ferramentas
Parâmetros, cuidados, erros e limites de cada ferramenta.
Autenticação da API
Escopos, rotação e guarda da chave de API.
⌘I
{"docsConfig":{"theme":"luma","$schema":"https://mintlify.com/docs.json","name":"sinnu developers","description":"Construa com a sinnu. Guias de integração, SDK TypeScript, componentes e referência da API de pagamentos.","colors":{"primary":"#465A00","light":"#C6F211","dark":"#7A8F34"},"logo":{"light":"https://mintcdn.com/sinnu/PQ0UtBEGrFaxApzL/assets/logo-light.svg?fit=max\u0026auto=format\u0026n=PQ0UtBEGrFaxApzL\u0026q=85\u0026s=c6fccb1b5a7c40ccce0d7fb25fb0fdc3","dark":"https://mintcdn.com/sinnu/PQ0UtBEGrFaxApzL/assets/logo-dark.svg?fit=max\u0026auto=format\u0026n=PQ0UtBEGrFaxApzL\u0026q=85\u0026s=e405a5c308c3b0bd369b37ca73b9eec3","href":"/"},"favicon":"https://mintcdn.com/sinnu/PQ0UtBEGrFaxApzL/assets/favicon.svg?fit=max\u0026auto=format\u0026n=PQ0UtBEGrFaxApzL\u0026q=85\u0026s=e96e738a49b8587926850b9c61923832","api":{"openapi":"api/openapi.yaml","playground":{"display":"none"},"examples":{"prefill":true,"autogenerate":false}},"appearance":{"default":"dark","strict":false},"background":{"color":{"light":"#FFFFFF","dark":"#0A0B09"}},"navbar":{"links":[{"href":"mailto:suporte@sinnu.com.br","label":"Suporte"}],"primary":{"type":"button","label":"Abrir painel","href":"https://app.sinnu.com.br"}},"footer":{"links":[{"header":"sinnu","items":[{"label":"Conheça a sinnu","href":"https://sinnu.com.br"},{"label":"Painel","href":"https://app.sinnu.com.br"}]},{"header":"Desenvolvedores","items":[{"label":"Suporte de integração","href":"mailto:suporte@sinnu.com.br"}]}]},"search":{"prompt":"Busque um guia, método ou componente..."},"fonts":{"heading":{"family":"Space Grotesk"},"body":{"family":"Instrument Sans"}},"icons":{"library":"lucide"},"contextual":{"options":["copy","view","claude","chatgpt","mcp","cursor","vscode"],"display":"header"},"markdown":{"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."]},"styling":{"latex":false},"navigation":{"languages":[{"language":"pt-BR","default":true,"href":""}]}},"deployment":{"deploymentMetadataValue":{"subdomain":"sinnu","hasAudioNarration":false,"actualSubdomain":"sinnu","customDomains":["docs.sinnu.com.br"],"gitSource":{"type":"github","owner":"ismcos","repo":"sinnu-docs","deployBranch":"main","contentDirectory":"","isPrivate":true,"mountPath":"","label":"","_id":"6ae3ceda60633356df40629f"},"entitlements":{"AI_CHAT":{"status":"DISABLED"},"WEB_MCP":{"status":"DISABLED"},"NARRATION":{"status":"DISABLED"}},"buildId":"6afaa2b9f20ad22eaaee5521","clientVersion":"0.0.4143","searchFilterCounts":[{"language":"pt-BR","tag":"Comece aqui","count":20},{"language":"pt-BR","tag":"API","count":14},{"language":"pt-BR","tag":"Elements","count":13},{"language":"pt-BR","tag":"SDK","count":9},{"language":"pt-BR","tag":"Construa com IA","count":7},{"language":"pt-BR","tag":"Links de pagamento","count":6},{"language":"pt-BR","tag":"Receba e acompanhe","count":6},{"language":"pt-BR","tag":"Referência do SDK","count":5},{"language":"pt-BR","tag":"Clientes","count":4},{"language":"pt-BR","tag":"Comunidade","count":4}]},"assistantConfig":{"enableAskAiButton":false,"enableStarterQuestions":false,"enableContextualStarterQuestions":false,"enableAskAiSearchBar":true},"basePath":"","hasChatPermissions":false,"hasWebMcpPermissions":false,"toggles":[{"name":"kill-isr","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"custom-rbac-roles","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"agent-mintlify-slack","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"agent-integrations-settings","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"rbac-expansion","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"automations-pr-grouping","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"custom-prefix","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"analytics-v7","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"user-flows-analytics","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"no-publish-flow","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"workos-onboarding","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"snapshot-serving-live","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"stripTemperatureMiddleware","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"support-platform-pylon-zendesk","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"snapshot-serving","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"instant-rollback","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"granular-notifications-server","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"granular-notifications","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"automations-fable","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"fixed-ai-action-pricing","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"automation-resolve-merge-conflict","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"scoped-publishing","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"mintql","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"page-level-analytics","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"editor-version-history-v2","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"billing-page-v2","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"full-page-search","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"workspace-projects","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"assistant-v5","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"fork-pr-previews","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"revalidation-jwt","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"workos-sso-scim","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"hobby-abuse-scan","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"dashboard-inbox","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"workos-signup","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"turbopuffer-dual-write","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"workos-enabled","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"approve-review-flow","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"editor-metadata","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"sso-setup-deadline-banner","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"turbopuffer-serve","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"live-agents","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"llms-txt-v2","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false}],"googleFontsInlined":true},"customCss":[{"filePath":"styles.css","content":":root{--sinnu-lime: #C6F211;--sinnu-on-lime: #0A0B09;--sinnu-panel: #F5F6F1;--sinnu-line: #DDE1D4;--sinnu-muted: #51564A;--sinnu-text: #15180F}.dark{--sinnu-panel: #141511;--sinnu-line: #303328;--sinnu-muted: #B2B7A6;--sinnu-text: #F4F4EF}.sinnu-eyebrow,.sinnu-preview-label{font-family:ui-monospace, SFMono-Regular, monospace;font-size:11px;font-weight:600;letter-spacing:.14em;color:var(--sinnu-muted)}.sinnu-home{padding:clamp(24px, 4vw, 64px);max-width:1600px;margin:0 auto;color:var(--sinnu-text)}.sinnu-home>h2{font-family:'Space Grotesk', sans-serif;font-size:26px;font-weight:600;margin:48px 0 24px;letter-spacing:-.03em}.sinnu-home>p{max-width:76ch;color:var(--sinnu-muted);line-height:1.75;margin:24px 0}.sinnu-home>p a{color:var(--sinnu-text);text-decoration:underline;text-underline-offset:3px}.sinnu-home table{width:100%;text-align:left;font-size:14px;border-collapse:collapse}.sinnu-home th,.sinnu-home td{padding:16px 20px 16px 0;border-bottom:1px solid var(--sinnu-line);vertical-align:top}.sinnu-home td{color:var(--sinnu-muted);line-height:1.7}.sinnu-hero-grid{display:grid;grid-template-columns:minmax(0, 1.15fr) minmax(0, 1fr);gap:clamp(28px, 4vw, 64px);align-items:center;padding-bottom:40px}.sinnu-hero-title{font-family:'Space Grotesk', sans-serif;font-size:clamp(2.4rem, 3.5vw, 4rem);font-weight:600;letter-spacing:-.06em;line-height:1.1;margin:24px 0;text-wrap:balance;color:var(--sinnu-text)}.sinnu-hero-copy{max-width:34rem;font-size:18px;line-height:1.7;color:var(--sinnu-muted);margin-bottom:28px}.sinnu-code-preview{min-width:0;border:1px solid var(--sinnu-line);border-radius:20px;background:var(--sinnu-panel);overflow:hidden}.sinnu-code-caption{display:flex;justify-content:space-between;align-items:center;padding:20px 24px;border-bottom:1px solid var(--sinnu-line)}.sinnu-code-dot{width:7px;height:7px;border-radius:50%;background:#465A00}.dark .sinnu-code-dot{background:var(--sinnu-lime)}.sinnu-code-preview pre{margin:0;padding:28px 24px;font-size:13px;line-height:1.9;overflow-x:auto;background:transparent}.sinnu-code-preview code{font-family:ui-monospace, SFMono-Regular, monospace;color:var(--sinnu-text)}.sinnu-code-muted{color:var(--sinnu-muted)}.sinnu-code-string{color:#465A00}.sinnu-code-number{color:#815F00}.dark .sinnu-code-string{color:#C6F211}.dark .sinnu-code-number{color:#E8B54A}.sinnu-code-result{display:flex;align-items:center;justify-content:space-between;flex-wrap:wrap;gap:16px;padding:20px 24px;border-top:1px solid var(--sinnu-line);font-size:13px;color:var(--sinnu-muted)}.sinnu-code-result a{color:var(--sinnu-text);text-decoration:underline;text-underline-offset:3px}.sinnu-code-result strong{color:var(--sinnu-text);font-size:20px;font-family:'Space Grotesk', sans-serif}@media (max-width: 1199px){.sinnu-hero-grid{grid-template-columns:1fr;gap:32px}}.sinnu-primary,.sinnu-pay-button{display:inline-flex;align-items:center;justify-content:center;gap:24px;min-height:44px;padding:12px 22px;border:0;border-radius:999px;background:var(--sinnu-lime);color:var(--sinnu-on-lime)!important;font-weight:650;text-decoration:none!important}.sinnu-primary:hover,a.sinnu-pay-button:hover{background:#D9FF3D}.sinnu-primary:focus-visible,.sinnu-pay-button:focus-visible{outline:3px solid #506600;outline-offset:4px}.dark .sinnu-primary:focus-visible,.dark .sinnu-pay-button:focus-visible{outline-color:#F4F4EF}.sinnu-flow{display:flex;flex-wrap:wrap;align-items:center;gap:14px;padding:24px;border:1px solid var(--sinnu-line);border-radius:16px;background:var(--sinnu-panel);color:var(--sinnu-muted);font-size:12px}.sinnu-flow b{margin-right:7px;font-family:ui-monospace, monospace;font-weight:500}.sinnu-component-preview,.sinnu-status-demo{border:1px solid var(--sinnu-line);border-radius:20px;padding:28px;background:var(--sinnu-panel);margin:28px 0}.sinnu-component-preview{display:flex;flex-direction:column;align-items:center;gap:24px}.sinnu-component-preview small{color:var(--sinnu-muted)}.sinnu-state-picker{border:0;padding:0;display:flex;flex-wrap:wrap;gap:8px}.sinnu-state-picker legend{font-weight:600;margin-bottom:14px}.sinnu-state-picker label{cursor:pointer;position:relative}.sinnu-state-picker input{position:absolute;opacity:0;width:1px;height:1px}.sinnu-state-picker span{display:inline-flex;align-items:center;min-height:44px;border:1px solid var(--sinnu-line);border-radius:999px;padding:7px 12px;font-size:12px}.sinnu-state-picker input:checked+span{background:var(--sinnu-lime);color:var(--sinnu-on-lime);border-color:var(--sinnu-lime)}.sinnu-state-picker input:focus-visible+span{outline:3px solid #506600;outline-offset:3px}.dark .sinnu-state-picker input:focus-visible+span{outline-color:#F4F4EF}.sinnu-status-card{margin-top:24px;padding:26px;border:1px solid var(--sinnu-line);border-radius:16px}.sinnu-demo-amount{font-family:'Space Grotesk', sans-serif;font-weight:600;font-size:38px;letter-spacing:-1.5px;margin:18px 0}.sinnu-status-line{font-weight:600}.sinnu-status-card p{color:var(--sinnu-muted);font-size:14px}.dark .sinnu-status-card[data-state=\"approved\"] .sinnu-status-line{color:#C6F211}.dark .sinnu-status-card[data-state=\"pending\"] .sinnu-status-line{color:#E8B54A}.dark .sinnu-status-card[data-state=\"refused\"] .sinnu-status-line{color:#E86A4A}@media (max-width: 480px){.sinnu-component-preview,.sinnu-status-demo{padding:18px}.sinnu-flow{align-items:flex-start;flex-direction:column}.sinnu-flow>span[aria-hidden]{display:none}}@media (prefers-reduced-motion: reduce){.sinnu-home *,.sinnu-status-demo *,.sinnu-component-preview *{animation:none!important;transition:none!important}}"}],"page":{"pagePath":"servidor-mcp/visao-geral","slug":"/servidor-mcp/visao-geral","pageMetadata":{"title":"Servidor MCP","description":"Conecte um assistente de IA à sua conta sinnu pelo login, autorizando a conexão no painel, ou com a chave de API da empresa.","href":"/servidor-mcp/visao-geral"},"description":{"compiledSource":"\"use strict\";\nconst {jsx: _jsx} = arguments[0];\nconst {useMDXComponents: _provideComponents} = arguments[0];\nfunction _createMdxContent(props) {\n const _components = {\n p: \"p\",\n ..._provideComponents(),\n ...props.components\n };\n return _jsx(_components.p, {\n children: \"Conecte um assistente de IA à sua conta sinnu pelo login, autorizando a conexão no painel, ou com a chave de API da empresa.\"\n });\n}\nfunction MDXContent(props = {}) {\n const {wrapper: MDXLayout} = {\n ..._provideComponents(),\n ...props.components\n };\n return MDXLayout ? _jsx(MDXLayout, {\n ...props,\n children: _jsx(_createMdxContent, {\n ...props\n })\n }) : _createMdxContent(props);\n}\nreturn {\n default: MDXContent\n};\n","frontmatter":{},"scope":{}},"pageType":"default","mdx":{"mdxSource":{"compiledSource":"\"use strict\";const{Fragment:_Fragment,jsx:_jsx,jsxs:_jsxs}=arguments[0];const{useMDXComponents:_provideComponents}=arguments[0];function _createMdxContent(props){const _components={a:`a`,code:`code`,li:`li`,ol:`ol`,p:`p`,pre:`pre`,span:`span`,strong:`strong`,tbody:`tbody`,td:`td`,th:`th`,thead:`thead`,tr:`tr`,ul:`ul`,..._provideComponents(),...props.components},{Card,CardGroup,CodeBlock,Frame,Heading,Info,OptimizedImage,Step,Steps,Table,Warning}=_components;if(!Card)_missingMdxReference(`Card`,true);if(!CardGroup)_missingMdxReference(`CardGroup`,true);if(!CodeBlock)_missingMdxReference(`CodeBlock`,true);if(!Frame)_missingMdxReference(`Frame`,true);if(!Heading)_missingMdxReference(`Heading`,true);if(!Info)_missingMdxReference(`Info`,true);if(!OptimizedImage)_missingMdxReference(`OptimizedImage`,true);if(!Step)_missingMdxReference(`Step`,true);if(!Steps)_missingMdxReference(`Steps`,true);if(!Table)_missingMdxReference(`Table`,true);if(!Warning)_missingMdxReference(`Warning`,true);return _jsxs(_Fragment,{children:[_jsx(_components.p,{children:`O servidor MCP da sinnu expõe a API pública como ferramentas do Model Context Protocol (MCP). Conectado a ele, um assistente consulta links de pagamento, transações e clientes da sua empresa e, quando a conexão permite, cria e altera links e clientes.`}),`\n`,_jsx(_components.p,{children:`O servidor é uma camada fina e sem estado: cada chamada de ferramenta vira uma chamada à API pública. Quem decide o que a conexão pode fazer continua sendo a API.`}),`\n`,_jsx(Info,{children:_jsxs(_components.p,{children:[`O servidor atende em `,_jsx(_components.code,{children:`https://mcp.sinnu.com.br/mcp`}),` e usa a API de produção: o que o assistente cria ou altera vale na conta da sua empresa. Não há ambiente de testes.`]})}),`\n`,_jsx(_components.p,{children:`Há duas formas de conectar um assistente:`}),`\n`,_jsxs(Table,{children:[_jsx(_components.thead,{children:_jsxs(_components.tr,{children:[_jsx(_components.th,{}),_jsx(_components.th,{children:`Login`}),_jsx(_components.th,{children:`Chave de API`})]})}),_jsxs(_components.tbody,{children:[_jsxs(_components.tr,{children:[_jsx(_components.td,{children:`Como funciona`}),_jsx(_components.td,{children:`O assistente abre o navegador, você entra no painel e autoriza a conexão para uma empresa.`}),_jsxs(_components.td,{children:[`A chave `,_jsx(_components.code,{children:`sk_live_...`}),` vai no cabeçalho `,_jsx(_components.code,{children:`Authorization`}),` de cada requisição.`]})]}),_jsxs(_components.tr,{children:[_jsx(_components.td,{children:`Acesso`}),_jsxs(_components.td,{children:[`O nível escolhido na autorização: `,_jsx(_components.strong,{children:`Somente leitura`}),` ou `,_jsx(_components.strong,{children:`Leitura e escrita`}),`.`]}),_jsx(_components.td,{children:`Os escopos da chave, com ou sem escrita.`})]}),_jsxs(_components.tr,{children:[_jsx(_components.td,{children:`Assistentes`}),_jsx(_components.td,{children:`Claude, Claude Code, ChatGPT, Cursor e VS Code.`}),_jsx(_components.td,{children:`Qualquer cliente MCP que envie um cabeçalho de requisição personalizado.`})]}),_jsxs(_components.tr,{children:[_jsx(_components.td,{children:`Como encerrar`}),_jsxs(_components.td,{children:[`Revogue em `,_jsx(_components.a,{href:`/servidor-mcp/conexoes-autorizadas`,children:`Conexões autorizadas`}),`.`]}),_jsxs(_components.td,{children:[`Revogue a chave em `,_jsx(_components.strong,{children:`Chave de API`}),`.`]})]})]})]}),`\n`,_jsx(_components.p,{children:`Prefira o login: ninguém copia nem guarda uma credencial fixa, e cada conexão aparece no painel com quem a autorizou e o nível de acesso, e pode ser revogada sem afetar as outras. Use a chave para um cliente sem login ou para escolher os escopos um a um, em vez de um dos dois níveis do login.`}),`\n`,_jsx(Heading,{level:`2`,id:`conecte-com-login`,children:`Conecte com login`}),`\n`,_jsxs(_components.p,{children:[`Você precisa ser Titular ou Administrador da empresa no `,_jsx(_components.a,{href:`https://app.sinnu.com.br`,children:`painel sinnu`}),` e usar um dos assistentes da tabela acima.`]}),`\n`,_jsx(Heading,{level:`3`,id:`escolha-o-nível-de-acesso`,children:`Escolha o nível de acesso`}),`\n`,_jsx(_components.p,{children:`Na autorização, você escolhe o que o assistente pode fazer na empresa:`}),`\n`,_jsxs(Table,{children:[_jsx(_components.thead,{children:_jsxs(_components.tr,{children:[_jsx(_components.th,{children:`Nível`}),_jsx(_components.th,{children:`Escopos da conexão`}),_jsx(_components.th,{children:`O que o assistente faz`})]})}),_jsxs(_components.tbody,{children:[_jsxs(_components.tr,{children:[_jsx(_components.td,{children:_jsx(_components.strong,{children:`Somente leitura`})}),_jsxs(_components.td,{children:[_jsx(_components.code,{children:`links:read`}),`, `,_jsx(_components.code,{children:`transactions:read`}),` e `,_jsx(_components.code,{children:`customers:read`})]}),_jsx(_components.td,{children:`Consulta links de pagamento, transações e clientes. Vê as 8 ferramentas de consulta.`})]}),_jsxs(_components.tr,{children:[_jsx(_components.td,{children:_jsx(_components.strong,{children:`Leitura e escrita`})}),_jsxs(_components.td,{children:[`Os três de leitura, mais `,_jsx(_components.code,{children:`links:write`}),` e `,_jsx(_components.code,{children:`customers:write`})]}),_jsx(_components.td,{children:`Também cria e altera links de pagamento e clientes. Vê as 12 ferramentas: as 8 de consulta e as 4 de escrita.`})]})]})]}),`\n`,_jsx(_components.p,{children:`A conexão recebe os escopos do nível escolhido, qualquer que seja o pedido do assistente. Nenhum dos dois níveis inclui Estorno, webhooks nem Carteira: o servidor não tem ferramenta que os use.`}),`\n`,_jsx(Warning,{children:_jsxs(_components.p,{children:[`Com `,_jsx(_components.strong,{children:`Leitura e escrita`}),`, o assistente pode criar e alterar links de pagamento 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 o assistente só vai consultar, escolha `,_jsx(_components.strong,{children:`Somente leitura`}),`.`]})}),`\n`,_jsxs(_components.p,{children:[`O nível não muda depois da autorização. Para trocar, revogue a conexão em `,_jsx(_components.a,{href:`/servidor-mcp/conexoes-autorizadas`,children:`Conexões autorizadas`}),` e conecte de novo pelo assistente, escolhendo o outro nível.`]}),`\n`,_jsx(Heading,{level:`3`,id:`passo-a-passo`,children:`Passo a passo`}),`\n`,_jsxs(Steps,{children:[_jsxs(Step,{title:`Adicione o servidor no assistente`,children:[_jsx(_components.p,{children:`Informe o endereço do servidor, sem parâmetros e sem cabeçalho:`}),_jsx(CodeBlock,{filename:`Endereço`,numberOfLines:`2`,language:`text`,children:_jsx(_components.pre,{className:`shiki shiki-themes github-light-default dark-plus`,style:{backgroundColor:`#ffffff`,\"--shiki-dark-bg\":`#0B0C0E`,color:`#1f2328`,\"--shiki-dark\":`#D4D4D4`},language:`text`,children:_jsxs(_components.code,{language:`text`,numberOfLines:`2`,children:[_jsx(_components.span,{className:`line`,children:_jsx(_components.span,{children:`https://mcp.sinnu.com.br/mcp`})}),`\n`,_jsx(_components.span,{className:`line`,children:_jsx(_components.span,{})})]})})}),_jsxs(_components.p,{children:[`Cada assistente tem o seu caminho: veja os guias em `,_jsx(_components.a,{href:`#conecte-pelo-seu-assistente`,children:`Conecte pelo seu assistente`}),`.`]})]}),_jsx(Step,{title:`Entre no painel`,children:_jsxs(_components.p,{children:[`O assistente abre no navegador a página de autorização da sinnu, no painel (`,_jsx(_components.code,{children:`app.sinnu.com.br`}),`). Se você não estiver logado, entre como de costume: ao terminar, o painel volta para a autorização.`]})}),_jsxs(Step,{title:`Autorize a conexão`,children:[_jsxs(_components.p,{children:[`Confira o nome do assistente e o endereço para onde o navegador volta depois de autorizar. Escolha a empresa e o `,_jsx(_components.a,{href:`#escolha-o-n%C3%ADvel-de-acesso`,children:`nível de acesso`}),` (`,_jsx(_components.strong,{children:`Somente leitura`}),` ou `,_jsx(_components.strong,{children:`Leitura e escrita`}),`), confirme com o código enviado ao seu e-mail, quando o painel pedir, e clique em `,_jsx(_components.strong,{children:`Autorizar`}),`.`]}),_jsx(_components.p,{children:`O pedido de autorização vale por 10 minutos e só no navegador em que foi aberto.`})]}),_jsx(Step,{title:`Confira a conexão`,children:_jsxs(_components.p,{children:[`O navegador volta ao assistente, que passa a usar a conexão. Peça a ele a conta conectada: ele chama `,_jsx(_components.code,{children:`get_account_context`}),`, que devolve a empresa e os escopos da conexão. Com `,_jsx(_components.strong,{children:`Leitura e escrita`}),`, os escopos incluem `,_jsx(_components.code,{children:`links:write`}),` e `,_jsx(_components.code,{children:`customers:write`}),`.`]})})]}),`\n`,_jsx(_components.p,{children:`O login funciona só com os assistentes da tabela. Outro cliente MCP é recusado na autorização: para ele, use a chave de API.`}),`\n`,_jsx(Heading,{level:`2`,id:`conecte-com-a-chave-de-api`,children:`Conecte com a chave de API`}),`\n`,_jsx(_components.p,{children:`A chave é o caminho para um cliente MCP sem login e para quem quer escolher os escopos um a um. Você precisa de um cliente MCP com suporte a servidor remoto por Streamable HTTP e a cabeçalho de requisição personalizado.`}),`\n`,_jsxs(Steps,{children:[_jsxs(Step,{title:`Crie uma chave para o assistente`,children:[_jsxs(_components.p,{children:[`No `,_jsx(_components.a,{href:`https://app.sinnu.com.br`,children:`painel`}),`, abra `,_jsx(_components.strong,{children:`Desenvolvedor > Chave de API`}),` e use `,_jsx(_components.strong,{children:`Nova chave`}),`. Escolha as permissões, confirme a criação com o código enviado por e-mail e copie a chave: ela não é exibida de novo.`]}),_jsx(Frame,{caption:`As permissões de leitura na janela Nova chave de API.`,children:_jsx(OptimizedImage,{src:`https://mintcdn.com/sinnu/jEiOLsL1SRJmKQfz/images/servidor-mcp/chave-de-api-leitura.png?fit=max\u0026auto=format\u0026n=jEiOLsL1SRJmKQfz\u0026q=85\u0026s=354ef6440d469ea5b26043d714331a28`,alt:`Janela Nova chave de API do painel da sinnu, com as permissões de leitura ligadas: Leitura (tudo), Transações — leitura, Clientes — leitura, Carteira — leitura e Links — leitura.`,\"data-og-width\":`511`,width:`511`,\"data-og-height\":`456`,height:`456`,\"data-path\":`images/servidor-mcp/chave-de-api-leitura.png`,\"data-optimize\":`true`,\"data-opv\":`3`,srcset:`https://mintcdn.com/sinnu/jEiOLsL1SRJmKQfz/images/servidor-mcp/chave-de-api-leitura.png?w=280\u0026fit=max\u0026auto=format\u0026n=jEiOLsL1SRJmKQfz\u0026q=85\u0026s=4b3ec2f6d545c916e58919cbe7f6af4d 280w, https://mintcdn.com/sinnu/jEiOLsL1SRJmKQfz/images/servidor-mcp/chave-de-api-leitura.png?w=560\u0026fit=max\u0026auto=format\u0026n=jEiOLsL1SRJmKQfz\u0026q=85\u0026s=4e08d85d4186cba20c3384d115870d96 560w, https://mintcdn.com/sinnu/jEiOLsL1SRJmKQfz/images/servidor-mcp/chave-de-api-leitura.png?w=840\u0026fit=max\u0026auto=format\u0026n=jEiOLsL1SRJmKQfz\u0026q=85\u0026s=7b15de8ad1d4197fe1b5ec44a641567a 840w, https://mintcdn.com/sinnu/jEiOLsL1SRJmKQfz/images/servidor-mcp/chave-de-api-leitura.png?w=1100\u0026fit=max\u0026auto=format\u0026n=jEiOLsL1SRJmKQfz\u0026q=85\u0026s=7f0bfce614b2ec1370e51c1a61010e73 1100w, https://mintcdn.com/sinnu/jEiOLsL1SRJmKQfz/images/servidor-mcp/chave-de-api-leitura.png?w=1650\u0026fit=max\u0026auto=format\u0026n=jEiOLsL1SRJmKQfz\u0026q=85\u0026s=828f8b5e8160b588d98f3e32309d5eda 1650w, https://mintcdn.com/sinnu/jEiOLsL1SRJmKQfz/images/servidor-mcp/chave-de-api-leitura.png?w=2500\u0026fit=max\u0026auto=format\u0026n=jEiOLsL1SRJmKQfz\u0026q=85\u0026s=744a8687b0176700949a04554db0236a 2500w`})}),_jsx(_components.p,{children:`Escolha as permissões pelo que o assistente vai fazer:`}),_jsxs(Table,{children:[_jsx(_components.thead,{children:_jsxs(_components.tr,{children:[_jsx(_components.th,{children:`O assistente vai`}),_jsx(_components.th,{children:`Permissões`})]})}),_jsxs(_components.tbody,{children:[_jsxs(_components.tr,{children:[_jsx(_components.td,{children:`Só consultar`}),_jsxs(_components.td,{children:[`As de leitura bastam: `,_jsx(_components.strong,{children:`Leitura (tudo)`}),`, ou só as que ele vai usar entre `,_jsx(_components.strong,{children:`Links — leitura`}),`, `,_jsx(_components.strong,{children:`Transações — leitura`}),` e `,_jsx(_components.strong,{children:`Clientes — leitura`}),`.`]})]}),_jsxs(_components.tr,{children:[_jsx(_components.td,{children:`Criar ou alterar links e clientes`}),_jsxs(_components.td,{children:[`Ligue também `,_jsx(_components.strong,{children:`Links — escrita`}),` e `,_jsx(_components.strong,{children:`Clientes — escrita`}),`. Mantenha as de leitura: as ferramentas de alteração podem ler o registro antes de gravar.`]})]})]})]}),_jsxs(_components.p,{children:[`Deixe `,_jsx(_components.strong,{children:`Transações — estorno`}),` e `,_jsx(_components.strong,{children:`Webhooks`}),` desligadas: o servidor MCP não tem ferramenta que as use. `,_jsx(_components.strong,{children:`Carteira — leitura`}),` também não é usada por nenhuma ferramenta. Veja o `,_jsx(_components.a,{href:`#escopos-e-ferramentas`,children:`escopo de cada ferramenta`}),`.`]})]}),_jsxs(Step,{title:`Configure o cliente MCP`,children:[_jsxs(_components.p,{children:[`Informe o endereço do servidor e envie a chave no cabeçalho `,_jsx(_components.code,{children:`Authorization`}),`. Muitos clientes aceitam uma configuração neste formato; os nomes dos campos variam, então confira a documentação do seu cliente.`]}),_jsx(CodeBlock,{filename:`Configuração do cliente`,numberOfLines:`11`,language:`json`,children:_jsx(_components.pre,{className:`shiki shiki-themes github-light-default dark-plus`,style:{backgroundColor:`#ffffff`,\"--shiki-dark-bg\":`#0B0C0E`,color:`#1f2328`,\"--shiki-dark\":`#D4D4D4`},language:`json`,children:_jsxs(_components.code,{language:`json`,numberOfLines:`11`,children:[_jsx(_components.span,{className:`line`,children:_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#D4D4D4`},children:`{`})}),`\n`,_jsxs(_components.span,{className:`line`,children:[_jsx(_components.span,{style:{color:`#116329`,\"--shiki-dark\":`#9CDCFE`},children:` \"mcpServers\"`}),_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#D4D4D4`},children:`: {`})]}),`\n`,_jsxs(_components.span,{className:`line`,children:[_jsx(_components.span,{style:{color:`#116329`,\"--shiki-dark\":`#9CDCFE`},children:` \"sinnu\"`}),_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#D4D4D4`},children:`: {`})]}),`\n`,_jsxs(_components.span,{className:`line`,children:[_jsx(_components.span,{style:{color:`#116329`,\"--shiki-dark\":`#9CDCFE`},children:` \"type\"`}),_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#D4D4D4`},children:`: `}),_jsx(_components.span,{style:{color:`#0A3069`,\"--shiki-dark\":`#CE9178`},children:`\"http\"`}),_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#D4D4D4`},children:`,`})]}),`\n`,_jsxs(_components.span,{className:`line`,children:[_jsx(_components.span,{style:{color:`#116329`,\"--shiki-dark\":`#9CDCFE`},children:` \"url\"`}),_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#D4D4D4`},children:`: `}),_jsx(_components.span,{style:{color:`#0A3069`,\"--shiki-dark\":`#CE9178`},children:`\"https://mcp.sinnu.com.br/mcp\"`}),_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#D4D4D4`},children:`,`})]}),`\n`,_jsxs(_components.span,{className:`line`,children:[_jsx(_components.span,{style:{color:`#116329`,\"--shiki-dark\":`#9CDCFE`},children:` \"headers\"`}),_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#D4D4D4`},children:`: {`})]}),`\n`,_jsxs(_components.span,{className:`line`,children:[_jsx(_components.span,{style:{color:`#116329`,\"--shiki-dark\":`#9CDCFE`},children:` \"Authorization\"`}),_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#D4D4D4`},children:`: `}),_jsx(_components.span,{style:{color:`#0A3069`,\"--shiki-dark\":`#CE9178`},children:`\"Bearer sk_live_...\"`})]}),`\n`,_jsx(_components.span,{className:`line`,children:_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#D4D4D4`},children:` }`})}),`\n`,_jsx(_components.span,{className:`line`,children:_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#D4D4D4`},children:` }`})}),`\n`,_jsx(_components.span,{className:`line`,children:_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#D4D4D4`},children:` }`})}),`\n`,_jsx(_components.span,{className:`line`,children:_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#D4D4D4`},children:`}`})}),`\n`]})})}),_jsxs(_components.p,{children:[`Substitua `,_jsx(_components.code,{children:`sk_live_...`}),` pela chave. Se o cliente oferecer mais de uma forma de autenticação, escolha a opção sem login e informe a chave como cabeçalho de requisição.`]})]}),_jsxs(Step,{title:`Confira a conexão`,children:[_jsxs(_components.p,{children:[`Peça ao assistente a conta conectada. Ele chama `,_jsx(_components.code,{children:`get_account_context`}),`, que devolve a empresa, os escopos da chave e se a conexão é somente leitura.`]}),_jsx(_components.p,{children:`Para conferir sem o assistente, liste as ferramentas com cURL:`}),_jsx(CodeBlock,{filename:`Terminal`,numberOfLines:`7`,language:`shellscript`,children:_jsx(_components.pre,{className:`shiki shiki-themes github-light-default dark-plus`,style:{backgroundColor:`#ffffff`,\"--shiki-dark-bg\":`#0B0C0E`,color:`#1f2328`,\"--shiki-dark\":`#D4D4D4`},language:`shellscript`,children:_jsxs(_components.code,{language:`shellscript`,numberOfLines:`7`,children:[_jsxs(_components.span,{className:`line`,children:[_jsx(_components.span,{style:{color:`#CF222E`,\"--shiki-dark\":`#569CD6`},children:`export`}),_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#9CDCFE`},children:` SINNU_API_KEY`}),_jsx(_components.span,{style:{color:`#CF222E`,\"--shiki-dark\":`#D4D4D4`},children:`=`}),_jsx(_components.span,{style:{color:`#0A3069`,\"--shiki-dark\":`#CE9178`},children:`'SUA_CHAVE_SECRETA'`})]}),`\n`,_jsx(_components.span,{className:`line`}),`\n`,_jsxs(_components.span,{className:`line`,children:[_jsx(_components.span,{style:{color:`#953800`,\"--shiki-dark\":`#DCDCAA`},children:`curl`}),_jsx(_components.span,{style:{color:`#0550AE`,\"--shiki-dark\":`#569CD6`},children:` --request`}),_jsx(_components.span,{style:{color:`#0A3069`,\"--shiki-dark\":`#CE9178`},children:` POST`}),_jsx(_components.span,{style:{color:`#0A3069`,\"--shiki-dark\":`#CE9178`},children:` 'https://mcp.sinnu.com.br/mcp'`}),_jsx(_components.span,{style:{color:`#CF222E`,\"--shiki-dark\":`#D7BA7D`},children:` \\\\`})]}),`\n`,_jsxs(_components.span,{className:`line`,children:[_jsx(_components.span,{style:{color:`#0550AE`,\"--shiki-dark\":`#569CD6`},children:` --header`}),_jsx(_components.span,{style:{color:`#0A3069`,\"--shiki-dark\":`#CE9178`},children:` \"Authorization: Bearer `}),_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#9CDCFE`},children:`$SINNU_API_KEY`}),_jsx(_components.span,{style:{color:`#0A3069`,\"--shiki-dark\":`#CE9178`},children:`\"`}),_jsx(_components.span,{style:{color:`#CF222E`,\"--shiki-dark\":`#D7BA7D`},children:` \\\\`})]}),`\n`,_jsxs(_components.span,{className:`line`,children:[_jsx(_components.span,{style:{color:`#0550AE`,\"--shiki-dark\":`#569CD6`},children:` --header`}),_jsx(_components.span,{style:{color:`#0A3069`,\"--shiki-dark\":`#CE9178`},children:` 'Content-Type: application/json'`}),_jsx(_components.span,{style:{color:`#CF222E`,\"--shiki-dark\":`#D7BA7D`},children:` \\\\`})]}),`\n`,_jsxs(_components.span,{className:`line`,children:[_jsx(_components.span,{style:{color:`#0550AE`,\"--shiki-dark\":`#569CD6`},children:` --header`}),_jsx(_components.span,{style:{color:`#0A3069`,\"--shiki-dark\":`#CE9178`},children:` 'Accept: application/json, text/event-stream'`}),_jsx(_components.span,{style:{color:`#CF222E`,\"--shiki-dark\":`#D7BA7D`},children:` \\\\`})]}),`\n`,_jsxs(_components.span,{className:`line`,children:[_jsx(_components.span,{style:{color:`#0550AE`,\"--shiki-dark\":`#569CD6`},children:` --data`}),_jsx(_components.span,{style:{color:`#0A3069`,\"--shiki-dark\":`#CE9178`},children:` '{\"jsonrpc\": \"2.0\", \"id\": 1, \"method\": \"tools/list\"}'`})]}),`\n`]})})}),_jsxs(_components.p,{children:[`Com esses cabeçalhos, a resposta vem em `,_jsx(_components.code,{children:`text/event-stream`}),`: o JSON-RPC está na linha `,_jsx(_components.code,{children:`data:`}),`, e `,_jsx(_components.code,{children:`result.tools`}),` traz as ferramentas que a chave enxerga.`]})]})]}),`\n`,_jsx(Heading,{level:`2`,id:`conecte-pelo-seu-assistente`,children:`Conecte pelo seu assistente`}),`\n`,_jsx(_components.p,{children:`Para um assistente específico, siga o guia dele:`}),`\n`,_jsxs(CardGroup,{cols:2,children:[_jsx(Card,{title:`Claude`,icon:`plug`,href:`/servidor-mcp/conectar-claude`,children:`Conector personalizado no Claude, com a imagem de cada passo, e o Claude Code no terminal.`}),_jsx(Card,{title:`ChatGPT`,icon:`message-square`,href:`/servidor-mcp/conectar-chatgpt`,children:`Servidor MCP personalizado no ChatGPT na web.`}),_jsx(Card,{title:`Cursor e VS Code`,icon:`code`,href:`/servidor-mcp/conectar-outros`,children:`Configuração só com o endereço e login no navegador. Outros clientes usam a chave.`}),_jsx(Card,{title:`Conexões autorizadas`,icon:`shield-check`,href:`/servidor-mcp/conexoes-autorizadas`,children:`Onde ver, revogar e acompanhar as conexões feitas pelo login.`})]}),`\n`,_jsx(Heading,{level:`2`,id:`endpoint`,children:`Endpoint`}),`\n`,_jsx(_components.p,{children:`O transporte é Streamable HTTP sem sessão: cada requisição é independente e leva uma única mensagem JSON-RPC.`}),`\n`,_jsxs(Table,{children:[_jsx(_components.thead,{children:_jsxs(_components.tr,{children:[_jsx(_components.th,{children:`Rota`}),_jsx(_components.th,{children:`Comportamento`})]})}),_jsxs(_components.tbody,{children:[_jsxs(_components.tr,{children:[_jsx(_components.td,{children:_jsx(_components.code,{children:`POST /mcp`})}),_jsx(_components.td,{children:`Endpoint MCP. Exige uma credencial: o token do login ou a chave de API.`})]}),_jsxs(_components.tr,{children:[_jsx(_components.td,{children:_jsx(_components.code,{children:`POST /mcp?readonly=true`})}),_jsxs(_components.td,{children:[`O mesmo endpoint em `,_jsx(_components.a,{href:`#modo-somente-leitura`,children:`modo somente leitura`}),`, para quem conecta com a chave.`]})]}),_jsxs(_components.tr,{children:[_jsxs(_components.td,{children:[_jsx(_components.code,{children:`GET`}),` ou `,_jsx(_components.code,{children:`DELETE`}),` em `,_jsx(_components.code,{children:`/mcp`})]}),_jsxs(_components.td,{children:[_jsx(_components.code,{children:`405`}),`, com `,_jsx(_components.code,{children:`Allow: POST`}),`.`]})]}),_jsxs(_components.tr,{children:[_jsx(_components.td,{children:_jsx(_components.code,{children:`GET /.well-known/oauth-protected-resource/mcp`})}),_jsxs(_components.td,{children:[`Metadados do recurso protegido (RFC 9728), sem autenticação: o endereço do servidor, o servidor de autorização e os escopos. O mesmo documento responde em `,_jsx(_components.code,{children:`/.well-known/oauth-protected-resource`}),`.`]})]}),_jsxs(_components.tr,{children:[_jsx(_components.td,{children:_jsx(_components.code,{children:`GET /healthz`})}),_jsxs(_components.td,{children:[_jsx(_components.code,{children:`200`}),` com `,_jsx(_components.code,{children:`{\"status\":\"ok\"}`}),`, sem autenticação.`]})]})]})]}),`\n`,_jsx(Heading,{level:`2`,id:`autenticação`,children:`Autenticação`}),`\n`,_jsxs(_components.p,{children:[`Toda requisição a `,_jsx(_components.code,{children:`/mcp`}),` leva uma credencial no cabeçalho `,_jsx(_components.code,{children:`Authorization`}),`: o token que o assistente recebe pelo login ou a chave `,_jsx(_components.code,{children:`sk_live_...`}),`.`]}),`\n`,_jsx(CodeBlock,{filename:`Header`,numberOfLines:`1`,language:`http`,children:_jsx(_components.pre,{className:`shiki shiki-themes github-light-default dark-plus`,style:{backgroundColor:`#ffffff`,\"--shiki-dark-bg\":`#0B0C0E`,color:`#1f2328`,\"--shiki-dark\":`#D4D4D4`},language:`http`,children:_jsxs(_components.code,{language:`http`,numberOfLines:`1`,children:[_jsxs(_components.span,{className:`line`,children:[_jsx(_components.span,{style:{color:`#116329`,\"--shiki-dark\":`#569CD6`},children:`Authorization`}),_jsx(_components.span,{style:{color:`#CF222E`,\"--shiki-dark\":`#569CD6`},children:`:`}),_jsx(_components.span,{style:{color:`#0A3069`,\"--shiki-dark\":`#CE9178`},children:` Bearer SUA_CREDENCIAL`})]}),`\n`]})})}),`\n`,_jsx(Heading,{level:`3`,id:`login`,children:`Login`}),`\n`,_jsx(_components.p,{children:`O login segue a autorização OAuth 2.1 da especificação MCP. O assistente conduz o fluxo sozinho; esta seção serve para entender o que acontece e investigar uma falha.`}),`\n`,_jsxs(_components.ol,{children:[`\n`,_jsxs(_components.li,{children:[`Sem credencial, o servidor responde `,_jsx(_components.code,{children:`401`}),`. O cabeçalho `,_jsx(_components.code,{children:`WWW-Authenticate`}),` traz `,_jsx(_components.code,{children:`resource_metadata`}),`, com o endereço dos metadados do recurso, e `,_jsx(_components.code,{children:`scope`}),`, com os escopos do nível `,_jsx(_components.strong,{children:`Somente leitura`}),`.`]}),`\n`,_jsxs(_components.li,{children:[`Os metadados do recurso apontam o servidor de autorização, `,_jsx(_components.code,{children:`https://auth.sinnu.com.br`}),`, que publica os dele em `,_jsx(_components.code,{children:`/.well-known/oauth-authorization-server`}),`.`]}),`\n`,_jsxs(_components.li,{children:[`O assistente se registra pelo registro dinâmico de cliente e abre a autorização no navegador, com PKCE (`,_jsx(_components.code,{children:`S256`}),`) e o parâmetro `,_jsx(_components.code,{children:`resource`}),` igual a `,_jsx(_components.code,{children:`https://mcp.sinnu.com.br/mcp`}),`.`]}),`\n`,_jsx(_components.li,{children:`Você entra no painel, escolhe a empresa e o nível e autoriza. A conexão recebe os escopos desse nível, mesmo que o assistente tenha pedido outros. O assistente troca o código recebido por um token de acesso, válido por 1 hora, e um token de renovação.`}),`\n`,_jsx(_components.li,{children:`O assistente renova o token de acesso sozinho. A cada renovação, o token de renovação anterior deixa de valer, e reapresentar um token de renovação já usado encerra o acesso: o assistente pede login de novo.`}),`\n`]}),`\n`,_jsxs(_components.p,{children:[`Só Titular ou Administrador da empresa autoriza uma conexão. As chamadas da conexão são feitas na empresa escolhida, em nome de quem autorizou. O link de pagamento criado pela conexão sai sem `,_jsx(_components.strong,{children:`Vendedor responsável`}),`, como o criado pela chave de API. Os Titulares da empresa recebem um e-mail a cada nova conexão autorizada, com o nível de acesso dela.`]}),`\n`,_jsxs(_components.p,{children:[`A conexão vale enquanto o assistente a usa e expira depois de 30 dias sem uso. Ela termina na hora quando alguém a revoga no painel ou quando quem autorizou deixa de ser membro ativo da empresa, perde o papel de Titular ou Administrador ou tem a conta desativada. Veja `,_jsx(_components.a,{href:`/servidor-mcp/conexoes-autorizadas`,children:`Conexões autorizadas`}),`.`]}),`\n`,_jsx(_components.p,{children:`O servidor MCP não repassa à API o token que recebe do assistente. Ele troca esse token, no servidor de autorização, por uma credencial aceita só pela API e válida pelo tempo que resta do token do assistente. O token do assistente, sozinho, não abre a API.`}),`\n`,_jsx(Heading,{level:`3`,id:`chave-de-api`,children:`Chave de API`}),`\n`,_jsxs(_components.p,{children:[`Com a chave, o cabeçalho leva `,_jsx(_components.code,{children:`Bearer`}),` e a chave `,_jsx(_components.code,{children:`sk_live_...`}),`. O servidor confere a chave na própria API e repassa essa mesma chave em cada chamada de ferramenta. Ele não tem usuário, senha nem credencial própria para a chave: sem ela, não lê nada.`]}),`\n`,_jsx(Heading,{level:`3`,id:`se-a-conexão-falhar`,children:`Se a conexão falhar`}),`\n`,_jsxs(_components.p,{children:[`As recusas da conexão voltam em JSON, com `,_jsx(_components.code,{children:`error`}),` e `,_jsx(_components.code,{children:`message`}),`.`]}),`\n`,_jsxs(Table,{children:[_jsx(_components.thead,{children:_jsxs(_components.tr,{children:[_jsx(_components.th,{children:`HTTP`}),_jsx(_components.th,{children:_jsx(_components.code,{children:`error`})}),_jsx(_components.th,{children:`Confira`})]})}),_jsxs(_components.tbody,{children:[_jsxs(_components.tr,{children:[_jsx(_components.td,{\"data-numeric\":`true`,children:_jsx(_components.code,{children:`401`})}),_jsx(_components.td,{children:_jsx(_components.code,{children:`unauthorized`})}),_jsx(_components.td,{children:`Nenhuma credencial foi enviada. Um assistente com login inicia a autorização a partir desta resposta.`})]}),_jsxs(_components.tr,{children:[_jsx(_components.td,{\"data-numeric\":`true`,children:_jsx(_components.code,{children:`401`})}),_jsx(_components.td,{children:_jsx(_components.code,{children:`invalid_token`})}),_jsxs(_components.td,{children:[`O cabeçalho não segue `,_jsx(_components.code,{children:`Bearer \u003ccredencial>`}),`, ou a credencial é inválida, expirou ou foi revogada. Com login, o assistente renova o token ou pede login de novo.`]})]}),_jsxs(_components.tr,{children:[_jsx(_components.td,{\"data-numeric\":`true`,children:_jsx(_components.code,{children:`400`})}),_jsx(_components.td,{children:_jsx(_components.code,{children:`invalid_query`})}),_jsxs(_components.td,{children:[`O endereço aceita só o parâmetro `,_jsx(_components.code,{children:`readonly`}),`, uma vez, com `,_jsx(_components.code,{children:`true`}),`, `,_jsx(_components.code,{children:`1`}),`, `,_jsx(_components.code,{children:`false`}),` ou `,_jsx(_components.code,{children:`0`}),`.`]})]}),_jsxs(_components.tr,{children:[_jsx(_components.td,{\"data-numeric\":`true`,children:_jsx(_components.code,{children:`413`})}),_jsx(_components.td,{children:_jsx(_components.code,{children:`payload_too_large`})}),_jsx(_components.td,{children:`O corpo da requisição passa de 64 KiB.`})]}),_jsxs(_components.tr,{children:[_jsx(_components.td,{\"data-numeric\":`true`,children:_jsx(_components.code,{children:`429`})}),_jsx(_components.td,{children:_jsx(_components.code,{children:`rate_limited`})}),_jsxs(_components.td,{children:[`Requisições ou credenciais recusadas demais em pouco tempo. Aguarde o intervalo de `,_jsx(_components.code,{children:`Retry-After`}),`, quando o cabeçalho vier.`]})]}),_jsxs(_components.tr,{children:[_jsx(_components.td,{\"data-numeric\":`true`,children:_jsx(_components.code,{children:`503`})}),_jsx(_components.td,{children:_jsx(_components.code,{children:`temporarily_unavailable`})}),_jsx(_components.td,{children:`O servidor não conseguiu validar a credencial agora. Tente de novo em instantes.`})]})]})]}),`\n`,_jsxs(_components.p,{children:[`Uma requisição com várias mensagens JSON-RPC (lote) é recusada com `,_jsx(_components.code,{children:`400`}),`: envie uma mensagem por requisição.`]}),`\n`,_jsx(Heading,{level:`3`,id:`se-a-autorização-falhar`,children:`Se a autorização falhar`}),`\n`,_jsx(_components.p,{children:`Na autorização pelo login, o painel explica o motivo da recusa:`}),`\n`,_jsxs(Table,{children:[_jsx(_components.thead,{children:_jsxs(_components.tr,{children:[_jsx(_components.th,{children:`Situação`}),_jsx(_components.th,{children:`O que fazer`})]})}),_jsxs(_components.tbody,{children:[_jsxs(_components.tr,{children:[_jsx(_components.td,{children:`O pedido expirou ou não é deste navegador.`}),_jsx(_components.td,{children:`Comece de novo pelo assistente e conclua a autorização em até 10 minutos, no navegador que ele abrir.`})]}),_jsxs(_components.tr,{children:[_jsx(_components.td,{children:`O pedido já foi respondido.`}),_jsx(_components.td,{children:`Volte ao assistente. Se ele não estiver conectado, conecte de novo.`})]}),_jsxs(_components.tr,{children:[_jsx(_components.td,{children:`Só Titular ou Administrador pode autorizar.`}),_jsx(_components.td,{children:`Peça a um Titular ou Administrador da empresa para autorizar, ou para mudar o seu papel na equipe.`})]}),_jsxs(_components.tr,{children:[_jsx(_components.td,{children:`A conexão com assistentes ainda não está disponível para a empresa.`}),_jsxs(_components.td,{children:[`O login não está disponível para a sua empresa neste momento. Enquanto isso, conecte com a `,_jsx(_components.a,{href:`#conecte-com-a-chave-de-api`,children:`chave de API`}),`.`]})]}),_jsxs(_components.tr,{children:[_jsx(_components.td,{children:`O assistente não foi reconhecido.`}),_jsx(_components.td,{children:`O login aceita só os assistentes da tabela do início desta página. Confira a configuração do assistente pelo guia dele ou use a chave de API.`})]}),_jsxs(_components.tr,{children:[_jsx(_components.td,{children:`A autorização está indisponível ou deu erro.`}),_jsx(_components.td,{children:`Tente de novo em instantes, começando pelo assistente.`})]})]})]}),`\n`,_jsx(Heading,{level:`2`,id:`escopos-e-ferramentas`,children:`Escopos e ferramentas`}),`\n`,_jsx(_components.p,{children:`A lista de ferramentas reflete o que a credencial permite: o nível de acesso escolhido no login ou os escopos da chave. Uma conexão sem escopo de escrita não enxerga as ferramentas de escrita. Isso evita que o assistente tente o que a API negaria; quem autoriza cada chamada continua sendo a API.`}),`\n`,_jsxs(Table,{children:[_jsx(_components.thead,{children:_jsxs(_components.tr,{children:[_jsx(_components.th,{children:`Ferramenta`}),_jsx(_components.th,{children:`Escopo`}),_jsx(_components.th,{children:`Tipo`}),_jsx(_components.th,{children:`Nível no login`})]})}),_jsxs(_components.tbody,{children:[_jsxs(_components.tr,{children:[_jsx(_components.td,{children:_jsx(_components.code,{children:`get_account_context`})}),_jsx(_components.td,{children:`Qualquer credencial válida`}),_jsx(_components.td,{children:`Consulta`}),_jsx(_components.td,{children:`Os dois`})]}),_jsxs(_components.tr,{children:[_jsx(_components.td,{children:_jsx(_components.code,{children:`list_payment_links`})}),_jsx(_components.td,{children:_jsx(_components.code,{children:`links:read`})}),_jsx(_components.td,{children:`Consulta`}),_jsx(_components.td,{children:`Os dois`})]}),_jsxs(_components.tr,{children:[_jsx(_components.td,{children:_jsx(_components.code,{children:`get_payment_link`})}),_jsx(_components.td,{children:_jsx(_components.code,{children:`links:read`})}),_jsx(_components.td,{children:`Consulta`}),_jsx(_components.td,{children:`Os dois`})]}),_jsxs(_components.tr,{children:[_jsx(_components.td,{children:_jsx(_components.code,{children:`list_payment_link_transactions`})}),_jsx(_components.td,{children:_jsx(_components.code,{children:`links:read`})}),_jsx(_components.td,{children:`Consulta`}),_jsx(_components.td,{children:`Os dois`})]}),_jsxs(_components.tr,{children:[_jsx(_components.td,{children:_jsx(_components.code,{children:`create_payment_link`})}),_jsx(_components.td,{children:_jsx(_components.code,{children:`links:write`})}),_jsx(_components.td,{children:`Escrita`}),_jsx(_components.td,{children:_jsx(_components.strong,{children:`Leitura e escrita`})})]}),_jsxs(_components.tr,{children:[_jsx(_components.td,{children:_jsx(_components.code,{children:`update_payment_link`})}),_jsxs(_components.td,{children:[_jsx(_components.code,{children:`links:write`}),`; para mudar `,_jsx(_components.code,{children:`status`}),`, também `,_jsx(_components.code,{children:`links:read`})]}),_jsx(_components.td,{children:`Escrita`}),_jsx(_components.td,{children:_jsx(_components.strong,{children:`Leitura e escrita`})})]}),_jsxs(_components.tr,{children:[_jsx(_components.td,{children:_jsx(_components.code,{children:`list_transactions`})}),_jsx(_components.td,{children:_jsx(_components.code,{children:`transactions:read`})}),_jsx(_components.td,{children:`Consulta`}),_jsx(_components.td,{children:`Os dois`})]}),_jsxs(_components.tr,{children:[_jsx(_components.td,{children:_jsx(_components.code,{children:`get_transaction`})}),_jsx(_components.td,{children:_jsx(_components.code,{children:`transactions:read`})}),_jsx(_components.td,{children:`Consulta`}),_jsx(_components.td,{children:`Os dois`})]}),_jsxs(_components.tr,{children:[_jsx(_components.td,{children:_jsx(_components.code,{children:`list_customers`})}),_jsx(_components.td,{children:_jsx(_components.code,{children:`customers:read`})}),_jsx(_components.td,{children:`Consulta`}),_jsx(_components.td,{children:`Os dois`})]}),_jsxs(_components.tr,{children:[_jsx(_components.td,{children:_jsx(_components.code,{children:`get_customer`})}),_jsx(_components.td,{children:_jsx(_components.code,{children:`customers:read`})}),_jsx(_components.td,{children:`Consulta`}),_jsx(_components.td,{children:`Os dois`})]}),_jsxs(_components.tr,{children:[_jsx(_components.td,{children:_jsx(_components.code,{children:`create_customer`})}),_jsx(_components.td,{children:_jsx(_components.code,{children:`customers:write`})}),_jsx(_components.td,{children:`Escrita`}),_jsx(_components.td,{children:_jsx(_components.strong,{children:`Leitura e escrita`})})]}),_jsxs(_components.tr,{children:[_jsx(_components.td,{children:_jsx(_components.code,{children:`update_customer`})}),_jsxs(_components.td,{children:[_jsx(_components.code,{children:`customers:write`}),` e `,_jsx(_components.code,{children:`customers:read`})]}),_jsx(_components.td,{children:`Escrita`}),_jsx(_components.td,{children:_jsx(_components.strong,{children:`Leitura e escrita`})})]})]})]}),`\n`,_jsxs(_components.p,{children:[`Veja o que `,_jsx(_components.a,{href:`/servidor-mcp/ferramentas`,children:`cada ferramenta`}),` faz.`]}),`\n`,_jsx(Heading,{level:`3`,id:`escopo-no-login`,children:`Escopo no login`}),`\n`,_jsxs(_components.p,{children:[`No login, a conexão recebe os escopos do `,_jsx(_components.a,{href:`#escolha-o-n%C3%ADvel-de-acesso`,children:`nível escolhido`}),`. `,_jsx(_components.strong,{children:`Somente leitura`}),` vê as 8 ferramentas de consulta; `,_jsx(_components.strong,{children:`Leitura e escrita`}),` vê as 12 e já inclui os escopos de leitura que `,_jsx(_components.code,{children:`update_payment_link`}),` e `,_jsx(_components.code,{children:`update_customer`}),` também usam.`]}),`\n`,_jsx(Heading,{level:`3`,id:`escopo-da-chave`,children:`Escopo da chave`}),`\n`,_jsxs(_components.p,{children:[`Com a chave, as ferramentas seguem os escopos dela. O escopo `,_jsx(_components.code,{children:`read`}),` cobre todos os escopos de leitura e nenhum de escrita. O escopo `,_jsx(_components.code,{children:`transactions:refund`}),` não libera nenhuma ferramenta: o servidor não faz estorno. Veja como `,_jsx(_components.a,{href:`/fundamentos/autenticacao#escolha-os-escopos`,children:`escolher os escopos`}),` da chave.`]}),`\n`,_jsx(Heading,{level:`2`,id:`modo-somente-leitura`,children:`Modo somente leitura`}),`\n`,_jsxs(_components.p,{children:[`Com login, o que a conexão pode fazer vem do nível escolhido na autorização: no nível `,_jsx(_components.strong,{children:`Somente leitura`}),`, ela não recebe escopo de escrita, e as ferramentas de escrita não aparecem. Use o endereço sem parâmetros: um endereço com parâmetro pode fazer a autorização falhar.`]}),`\n`,_jsxs(_components.p,{children:[`Com a chave, acrescente `,_jsx(_components.code,{children:`?readonly=true`}),` ao endereço para uma conexão que só consulta:`]}),`\n`,_jsx(CodeBlock,{filename:`Endereço somente leitura`,numberOfLines:`2`,language:`text`,children:_jsx(_components.pre,{className:`shiki shiki-themes github-light-default dark-plus`,style:{backgroundColor:`#ffffff`,\"--shiki-dark-bg\":`#0B0C0E`,color:`#1f2328`,\"--shiki-dark\":`#D4D4D4`},language:`text`,children:_jsxs(_components.code,{language:`text`,numberOfLines:`2`,children:[_jsx(_components.span,{className:`line`,children:_jsx(_components.span,{children:`https://mcp.sinnu.com.br/mcp?readonly=true`})}),`\n`,_jsx(_components.span,{className:`line`,children:_jsx(_components.span,{})})]})})}),`\n`,_jsxs(_components.p,{children:[`Nesse modo o servidor oferece só as ferramentas de consulta (8, com uma chave que lê tudo), mesmo que a chave tenha escopos de escrita, e bloqueia qualquer chamada à API que não seja uma consulta. `,_jsx(_components.code,{children:`get_account_context`}),` devolve `,_jsx(_components.code,{children:`readOnly: true`}),`. Pelo login, com o endereço sem parâmetros, `,_jsx(_components.code,{children:`readOnly`}),` vem `,_jsx(_components.code,{children:`false`}),` nos dois níveis: o nível aparece nos escopos.`]}),`\n`,_jsxs(_components.p,{children:[`O parâmetro aceita `,_jsx(_components.code,{children:`true`}),` ou `,_jsx(_components.code,{children:`1`}),` para ligar e `,_jsx(_components.code,{children:`false`}),` ou `,_jsx(_components.code,{children:`0`}),` para desligar. Outro valor, o parâmetro repetido ou qualquer outro parâmetro no endereço é recusado com `,_jsx(_components.code,{children:`400`}),`: o servidor nunca abre uma conexão com escrita para quem pediu somente leitura de um jeito que ele não reconhece.`]}),`\n`,_jsx(Heading,{level:`2`,id:`segurança`,children:`Segurança`}),`\n`,_jsx(_components.p,{children:`A conexão dá ao assistente acesso aos dados da sua empresa. Trate-a como trataria um sistema com acesso à sua conta.`}),`\n`,_jsxs(_components.ul,{children:[`\n`,_jsxs(_components.li,{children:[_jsx(_components.strong,{children:`Autorize só o que você pediu.`}),` Abra a autorização a partir do assistente e confira que a página é do painel (`,_jsx(_components.code,{children:`app.sinnu.com.br`}),`), com o nome do assistente e o endereço de retorno que você espera. Se alguém te mandou um link de autorização, cancele.`]}),`\n`,_jsxs(_components.li,{children:[_jsx(_components.strong,{children:`Revogue o que não usa.`}),` As conexões feitas pelo login ficam em `,_jsx(_components.a,{href:`/servidor-mcp/conexoes-autorizadas`,children:`Conexões autorizadas`}),`, cada uma com quem a autorizou e o nível de acesso.`]}),`\n`,_jsxs(_components.li,{children:[_jsx(_components.strong,{children:`No login, escolha o menor nível.`}),` Para um assistente que só consulta, autorize `,_jsx(_components.strong,{children:`Somente leitura`}),`.`]}),`\n`,_jsxs(_components.li,{children:[_jsx(_components.strong,{children:`Com a chave, use uma chave dedicada, com o menor escopo.`}),` Uma chave só para o assistente pode ser revogada sem afetar as outras integrações. Para um assistente que só consulta, combine uma chave de leitura com `,_jsx(_components.code,{children:`?readonly=true`}),`.`]}),`\n`,_jsxs(_components.li,{children:[_jsx(_components.strong,{children:`Revise as escritas.`}),` Com `,_jsx(_components.strong,{children:`Leitura e escrita`}),` no login, ou com uma chave com escopo de escrita, o assistente pode criar e alterar links e clientes. 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. Criar link e cadastrar cliente não são idempotentes, e alterar sobrescreve o valor atual.`]}),`\n`,_jsxs(_components.li,{children:[_jsx(_components.strong,{children:`Trate textos de terceiros como dados.`}),` Nomes, e-mails, descrições, observações e referências são escritos por compradores e por outras pessoas. O servidor orienta o modelo a não os seguir como instruções, mas essa orientação não substitui a sua revisão.`]}),`\n`,_jsxs(_components.li,{children:[_jsx(_components.strong,{children:`Cuide dos dados pessoais.`}),` O cadastro completo de um cliente, com documento e endereço, chega ao assistente quando ele consulta o cliente. Os dois níveis do login incluem `,_jsx(_components.code,{children:`customers:read`}),`; com a chave, conceda esse escopo só se o assistente precisar.`]}),`\n`,_jsxs(_components.li,{children:[_jsx(_components.strong,{children:`Se a credencial vazar, revogue.`}),` Revogue a conexão em `,_jsx(_components.strong,{children:`Conexões autorizadas`}),` ou a chave em `,_jsx(_components.strong,{children:`Chave de API`}),`. A API passa a recusar a credencial revogada, inclusive nas chamadas feitas pelo servidor MCP.`]}),`\n`]}),`\n`,_jsx(_components.p,{children:`O servidor não tem banco de dados e não guarda credenciais entre requisições: mantém em memória só o hash da credencial recebida, para reaproveitar a validação por até 60 segundos com a chave e por até 5 minutos com o login, e não a escreve em log.`}),`\n`,_jsx(Heading,{level:`2`,id:`limites-atuais`,children:`Limites atuais`}),`\n`,_jsxs(_components.ul,{children:[`\n`,_jsx(_components.li,{children:`O login funciona com Claude, Claude Code, ChatGPT, Cursor e VS Code. Outros clientes usam a chave de API.`}),`\n`,_jsx(_components.li,{children:`No login, os escopos vêm em dois níveis fixos. Para escolher escopo por escopo, como escrita só em links, use a chave de API.`}),`\n`,_jsx(_components.li,{children:`As ferramentas cobrem links de pagamento, transações e clientes. O servidor não faz estorno, não arquiva nem exclui link, não reativa link arquivado, não exclui cliente, não consulta o saldo da carteira nem saques e não gerencia webhooks.`}),`\n`,_jsx(_components.li,{children:`A criação de link é só de valor fixo e pagamento avulso.`}),`\n`]}),`\n`,_jsxs(CardGroup,{cols:2,children:[_jsx(Card,{title:`Ferramentas`,icon:`wrench`,href:`/servidor-mcp/ferramentas`,children:`Parâmetros, cuidados, erros e limites de cada ferramenta.`}),_jsx(Card,{title:`Autenticação da API`,icon:`key-round`,href:`/fundamentos/autenticacao`,children:`Escopos, rotação e guarda da chave de API.`})]})]})}function MDXContent(props={}){const{wrapper:MDXLayout}={..._provideComponents(),...props.components};return MDXLayout?_jsx(MDXLayout,{...props,children:_jsx(_createMdxContent,{...props})}):_createMdxContent(props)}return{default:MDXContent};function _missingMdxReference(id,component){throw new Error(`Expected `+(component?`component`:`object`)+\" `\"+id+\"` to be defined: you likely forgot to import, pass, or provide it.\")}","frontmatter":{},"scope":{"config":{},"pageMetadata":{"title":"Servidor MCP","description":"Conecte um assistente de IA à sua conta sinnu pelo login, autorizando a conexão no painel, ou com a chave de API da empresa.","href":"/servidor-mcp/visao-geral"}}},"mdxSourceWithNoJs":null},"mdxExtracts":{"tableOfContents":[{"title":"Conecte com login","slug":"conecte-com-login","depth":2,"children":[{"title":"Escolha o nível de acesso","slug":"escolha-o-nível-de-acesso","depth":3,"children":[]},{"title":"Passo a passo","slug":"passo-a-passo","depth":3,"children":[]}]},{"title":"Conecte com a chave de API","slug":"conecte-com-a-chave-de-api","depth":2,"children":[]},{"title":"Conecte pelo seu assistente","slug":"conecte-pelo-seu-assistente","depth":2,"children":[]},{"title":"Endpoint","slug":"endpoint","depth":2,"children":[]},{"title":"Autenticação","slug":"autenticação","depth":2,"children":[{"title":"Login","slug":"login","depth":3,"children":[]},{"title":"Chave de API","slug":"chave-de-api","depth":3,"children":[]},{"title":"Se a conexão falhar","slug":"se-a-conexão-falhar","depth":3,"children":[]},{"title":"Se a autorização falhar","slug":"se-a-autorização-falhar","depth":3,"children":[]}]},{"title":"Escopos e ferramentas","slug":"escopos-e-ferramentas","depth":2,"children":[{"title":"Escopo no login","slug":"escopo-no-login","depth":3,"children":[]},{"title":"Escopo da chave","slug":"escopo-da-chave","depth":3,"children":[]}]},{"title":"Modo somente leitura","slug":"modo-somente-leitura","depth":2,"children":[]},{"title":"Segurança","slug":"segurança","depth":2,"children":[]},{"title":"Limites atuais","slug":"limites-atuais","depth":2,"children":[]}],"codeExamples":{}},"jsLinks":[],"subdomain":"sinnu","siteName":"sinnu developers","title":"Servidor MCP - sinnu developers","navMaps":{"firstHrefInVersion":{},"firstHrefInLanguage":{"pt-BR":{"href":"/servidor-mcp/visao-geral","matchLevel":0}}},"lastModified":"2026-11-16T06:29:18.939Z","originalFileLocation":"servidor-mcp/visao-geral.mdx","locale":"pt-BR"},"headHtml":"\u003cscript data-mint-head>(function(){var d=document.documentElement,p=null;if(!p){try{p=localStorage.getItem(\"isDarkMode\")}catch(e){}if(p==='true')p='dark';else if(p==='false')p='light';if(p!=='light'\u0026\u0026p!=='dark'\u0026\u0026p!=='system')p=\"dark\"}var r=p==='system'?(matchMedia(\"(prefers-color-scheme: dark)\").matches?'dark':'light'):p;d.classList.remove(r==='dark'?'light':'dark');d.classList.add(r);d.setAttribute(\"data-theme-preference\",p)})();\u003c/script>\u003cmeta data-mint-head name=\"description\" content=\"Conecte um assistente de IA à sua conta sinnu pelo login, autorizando a conexão no painel, ou com a chave de API da empresa.\">\u003cmeta data-mint-head name=\"application-name\" content=\"sinnu developers\">\u003cmeta data-mint-head name=\"generator\" content=\"Mintlify\">\u003clink data-mint-head rel=\"icon\" type=\"image/png\" sizes=\"192x192\" href=\"/mintlify-assets/_mintlify/favicons/sinnu/1s9d9O-UUgF97uqF/_generated/favicon/android-chrome-192x192.png\" media=\"(prefers-color-scheme: light)\">\u003clink data-mint-head rel=\"apple-touch-icon\" type=\"image/png\" sizes=\"180x180\" href=\"/mintlify-assets/_mintlify/favicons/sinnu/1s9d9O-UUgF97uqF/_generated/favicon/apple-touch-icon.png\">\u003clink data-mint-head rel=\"icon\" type=\"image/png\" sizes=\"16x16\" href=\"/mintlify-assets/_mintlify/favicons/sinnu/1s9d9O-UUgF97uqF/_generated/favicon/favicon-16x16.png\" media=\"(prefers-color-scheme: light)\">\u003clink data-mint-head rel=\"icon\" type=\"image/png\" sizes=\"32x32\" href=\"/mintlify-assets/_mintlify/favicons/sinnu/1s9d9O-UUgF97uqF/_generated/favicon/favicon-32x32.png\" media=\"(prefers-color-scheme: light)\">\u003clink data-mint-head rel=\"shortcut icon\" type=\"image/x-icon\" href=\"/mintlify-assets/_mintlify/favicons/sinnu/1s9d9O-UUgF97uqF/_generated/favicon/favicon.ico\" media=\"(prefers-color-scheme: light)\">\u003clink data-mint-head rel=\"icon\" type=\"image/png\" sizes=\"192x192\" href=\"/mintlify-assets/_mintlify/favicons/sinnu/1s9d9O-UUgF97uqF/_generated/favicon-dark/android-chrome-192x192.png\" media=\"(prefers-color-scheme: dark)\">\u003clink data-mint-head rel=\"icon\" type=\"image/png\" sizes=\"16x16\" href=\"/mintlify-assets/_mintlify/favicons/sinnu/1s9d9O-UUgF97uqF/_generated/favicon-dark/favicon-16x16.png\" media=\"(prefers-color-scheme: dark)\">\u003clink data-mint-head rel=\"icon\" type=\"image/png\" sizes=\"32x32\" href=\"/mintlify-assets/_mintlify/favicons/sinnu/1s9d9O-UUgF97uqF/_generated/favicon-dark/favicon-32x32.png\" media=\"(prefers-color-scheme: dark)\">\u003clink data-mint-head rel=\"shortcut icon\" type=\"image/x-icon\" href=\"/mintlify-assets/_mintlify/favicons/sinnu/1s9d9O-UUgF97uqF/_generated/favicon-dark/favicon.ico\" media=\"(prefers-color-scheme: dark)\">\u003cmeta data-mint-head property=\"og:title\" content=\"Servidor MCP - sinnu developers\">\u003cmeta data-mint-head property=\"og:description\" content=\"Conecte um assistente de IA à sua conta sinnu pelo login, autorizando a conexão no painel, ou com a chave de API da empresa.\">\u003cmeta data-mint-head property=\"og:site_name\" content=\"sinnu developers\">\u003cmeta data-mint-head property=\"og:url\" content=\"https://docs.sinnu.com.br/servidor-mcp/visao-geral\">\u003cmeta data-mint-head property=\"og:type\" content=\"website\">\u003cmeta data-mint-head property=\"og:image\" content=\"https://sinnu.mintlify.site/_mintlify/api/og/v2?division=Construa+com+IA\u0026amp;title=Servidor+MCP\u0026amp;description=Conecte+um+assistente+de+IA+%C3%A0+sua+conta+sinnu+pelo+login%2C+autorizando+a+conex%C3%A3o+no+painel%2C+ou+com+a+chave+de+API+da+empresa.\u0026amp;theme=2c5c0fba980a3ba486a3b1a0\u0026amp;signature=448ea9dd389b6104ed7fbc3e914d7f7cf7a2000c10cbe98b3b3cc01fc3024765\">\u003cmeta data-mint-head property=\"og:image:width\" content=\"1200\">\u003cmeta data-mint-head property=\"og:image:height\" content=\"630\">\u003cmeta data-mint-head name=\"twitter:card\" content=\"summary_large_image\">\u003cmeta data-mint-head name=\"twitter:title\" content=\"Servidor MCP - sinnu developers\">\u003cmeta data-mint-head name=\"twitter:description\" content=\"Conecte um assistente de IA à sua conta sinnu pelo login, autorizando a conexão no painel, ou com a chave de API da empresa.\">\u003cmeta data-mint-head name=\"twitter:image\" content=\"https://sinnu.mintlify.site/_mintlify/api/og/v2?division=Construa+com+IA\u0026amp;title=Servidor+MCP\u0026amp;description=Conecte+um+assistente+de+IA+%C3%A0+sua+conta+sinnu+pelo+login%2C+autorizando+a+conex%C3%A3o+no+painel%2C+ou+com+a+chave+de+API+da+empresa.\u0026amp;theme=2c5c0fba980a3ba486a3b1a0\u0026amp;signature=448ea9dd389b6104ed7fbc3e914d7f7cf7a2000c10cbe98b3b3cc01fc3024765\">\u003cmeta data-mint-head name=\"twitter:image:width\" content=\"1200\">\u003cmeta data-mint-head name=\"twitter:image:height\" content=\"630\">\u003cmeta data-mint-head name=\"msapplication-config\" content=\"/mintlify-assets/_mintlify/favicons/sinnu/1s9d9O-UUgF97uqF/_generated/favicon/browserconfig.xml\">\u003cmeta data-mint-head name=\"apple-mobile-web-app-title\" content=\"sinnu developers\">\u003cmeta data-mint-head name=\"msapplication-TileColor\" content=\"#465A00\">\u003clink data-mint-head rel=\"canonical\" href=\"https://docs.sinnu.com.br/servidor-mcp/visao-geral\">\u003clink data-mint-head rel=\"alternate\" type=\"application/xml\" href=\"/sitemap.xml\">\u003clink data-mint-head rel=\"alternate\" type=\"text/markdown\" href=\"/servidor-mcp/visao-geral.md\">\u003cscript data-mint-head type=\"application/ld+json\">{\"@context\":\"https://schema.org\",\"@graph\":[{\"@type\":\"Organization\",\"@id\":\"https://docs.sinnu.com.br/#organization\",\"name\":\"sinnu developers\",\"url\":\"https://docs.sinnu.com.br\",\"logo\":{\"@type\":\"ImageObject\",\"url\":\"https://mintcdn.com/sinnu/PQ0UtBEGrFaxApzL/assets/logo-light.svg?fit=max\u0026auto=format\u0026n=PQ0UtBEGrFaxApzL\u0026q=85\u0026s=c6fccb1b5a7c40ccce0d7fb25fb0fdc3\"}},{\"@type\":\"WebSite\",\"@id\":\"https://docs.sinnu.com.br#website\",\"name\":\"sinnu developers\",\"url\":\"https://docs.sinnu.com.br\",\"publisher\":{\"@id\":\"https://docs.sinnu.com.br/#organization\"}},{\"@type\":\"WebPage\",\"@id\":\"https://docs.sinnu.com.br/servidor-mcp/visao-geral#webpage\",\"url\":\"https://docs.sinnu.com.br/servidor-mcp/visao-geral\",\"name\":\"Servidor MCP\",\"description\":\"Conecte um assistente de IA à sua conta sinnu pelo login, autorizando a conexão no painel, ou com a chave de API da empresa.\",\"dateModified\":\"2026-11-16T06:29:18.939Z\",\"isPartOf\":{\"@id\":\"https://docs.sinnu.com.br#website\"},\"breadcrumb\":{\"@id\":\"https://docs.sinnu.com.br/servidor-mcp/visao-geral#breadcrumb\"}},{\"@type\":\"BreadcrumbList\",\"@id\":\"https://docs.sinnu.com.br/servidor-mcp/visao-geral#breadcrumb\",\"itemListElement\":[{\"@type\":\"ListItem\",\"position\":1,\"name\":\"Construa com IA\",\"item\":\"https://docs.sinnu.com.br/ia/documentacao-para-ia\"},{\"@type\":\"ListItem\",\"position\":2,\"name\":\"Servidor MCP\",\"item\":\"https://docs.sinnu.com.br/servidor-mcp/visao-geral\"}]},{\"@type\":[\"Article\",\"TechArticle\"],\"@id\":\"https://docs.sinnu.com.br/servidor-mcp/visao-geral#article\",\"headline\":\"Servidor MCP\",\"name\":\"Servidor MCP\",\"description\":\"Conecte um assistente de IA à sua conta sinnu pelo login, autorizando a conexão no painel, ou com a chave de API da empresa.\",\"url\":\"https://docs.sinnu.com.br/servidor-mcp/visao-geral\",\"mainEntityOfPage\":{\"@id\":\"https://docs.sinnu.com.br/servidor-mcp/visao-geral#webpage\"},\"dateModified\":\"2026-11-16T06:29:18.939Z\",\"publisher\":{\"@id\":\"https://docs.sinnu.com.br/#organization\"},\"isPartOf\":{\"@id\":\"https://docs.sinnu.com.br#website\"}}]}\u003c/script>\u003cscript data-mint-head type=\"application/ld+json\">{\"@context\":\"https://schema.org\",\"@type\":\"WebSite\",\"name\":\"sinnu developers\",\"publisher\":{\"@type\":\"Organization\",\"name\":\"sinnu developers\"},\"provider\":{\"@type\":\"Organization\",\"name\":\"Mintlify\",\"url\":\"https://mintlify.com\"}}\u003c/script>","agentPointerHref":"/servidor-mcp/visao-geral.md","siteName":"sinnu developers","nav":{"global":null,"languages":[{"language":"pt-BR","default":true,"tabs":[{"tab":"Comece aqui","icon":"compass","groups":[{"group":"Construa com a sinnu","pages":[{"mode":"frame","title":"Documentação sinnu","sidebarTitle":"Visão geral","icon":"compass","href":""},{"title":"Crie seu primeiro link","href":"/inicio/primeiro-link"},{"title":"Escolha sua integração","href":"/inicio/escolha-sua-integracao"}]},{"group":"Fundamentos","pages":[{"title":"Autenticação","href":"/fundamentos/autenticacao"},{"title":"Valores, identificadores e status","href":"/fundamentos/valores-e-status"},{"title":"Erros e limites","href":"/fundamentos/erros-e-limites"}]},{"group":"Receba e acompanhe","pages":[{"title":"Links de pagamento","href":"/guias/links-de-pagamento"},{"title":"Abra o checkout","href":"/guias/checkout"},{"title":"Rastreie a origem das vendas","href":"/guias/rastreamento"},{"title":"Receba webhooks","href":"/guias/webhooks"},{"title":"Concilie pagamentos","href":"/guias/conciliacao"},{"title":"Receba avisos no Discord","href":"/guias/discord"}]},{"group":"Construa com IA","pages":[{"title":"Documentação para assistentes de IA","sidebarTitle":"Documentação para IA","description":"Leve este portal para o seu assistente: em Markdown, pelo llms.txt, pelo servidor MCP da documentação ou como skill.","href":"/ia/documentacao-para-ia"},{"title":"Servidor MCP","href":"/servidor-mcp/visao-geral"},{"title":"Conecte o Claude ao servidor MCP","sidebarTitle":"Claude","description":"Adicione o servidor MCP da sinnu como conector personalizado no Claude, entre com a sua conta e autorize a conexão no painel.","href":"/servidor-mcp/conectar-claude"},{"title":"Conecte o ChatGPT ao servidor MCP","sidebarTitle":"ChatGPT","href":"/servidor-mcp/conectar-chatgpt"},{"title":"Conecte o Cursor, o VS Code e outros clientes","sidebarTitle":"Cursor e VS Code","href":"/servidor-mcp/conectar-outros"},{"title":"Conexões autorizadas","href":"/servidor-mcp/conexoes-autorizadas"},{"title":"Ferramentas do servidor MCP","sidebarTitle":"Ferramentas MCP","href":"/servidor-mcp/ferramentas"}]},{"group":"Conta e segurança","pages":[{"title":"Confirme saques com app autenticador","sidebarTitle":"App autenticador","icon":"shield-check","href":"/seguranca/app-autenticador"}]}]},{"tab":"SDK","icon":"braces","pages":[{"title":"SDK","href":"/sdk/visao-geral"}]},{"tab":"Elements","icon":"app-window","pages":[{"title":"Elements","href":"/elements/visao-geral"}]},{"tab":"API","icon":"terminal","pages":[{"title":"API","href":"/api/introducao"}]},{"tab":"Comunidade","icon":"users","pages":[{"title":"Comunidade","href":"/comunidade/visao-geral"}]}]}]},"basePath":"","title":"Servidor MCP - sinnu developers","buildId":"dpl_Fyv1NbzwP68g2bEH2Roy98uY1zmE","deploymentId":"dpl_Fyv1NbzwP68g2bEH2Roy98uY1zmE","dynamics":["07c022d89b","a74be98ba7"],"chunks":["Frame-D2acuaLg.js","DynamicMarkdown-Co5nikxh.js","zoom-image-lightbox-BbK2OBGL.js","lightbox-handle-r17bVUz3.js"]}