EstávelUsuário
Conecte sua IA ao Blocchi
Use o contexto de negócio governado do Blocchi no ChatGPT, Claude, Cursor e outros clientes MCP.
Escolha seu assistente para conectar ao Blocchi pelo Model Context Protocol (MCP). Comece com acesso somente leitura e amplie as permissões apenas quando necessário. Não é preciso instalar um servidor MCP local.
Como funciona
- Escolha um cliente e informe o endereço MCP remoto:
https://www.blocchi.ai/api/mcp. - Autorize o acesso usando o login Blocchi, se o cliente suportar o fluxo OAuth publicado, ou configure uma chave com escopo limitado nas configurações seguras do conector.
- Use Testar meu acesso nas Configurações de desenvolvedor para verificar as ferramentas disponíveis à sua sessão do navegador. Isso não testa a conexão da IA.
- Teste uma pergunta somente leitura no cliente de IA, verificando evidências reais e autorizadas. Uma conexão bem-sucedida não significa que a fonte já sincronizou.
- Revise as permissões. O Blocchi continua validando tenant, papel, escopo de dados, produtos habilitados, fontes e aprovações de ações.
Escolha seu guia
| Seu objetivo | Guia |
|---|---|
| Perguntar ao ChatGPT sobre o Blocchi | ChatGPT |
| Conectar Claude na web ou desktop | Claude |
| Usar no editor de código | Cursor e agentes de código |
| Configurar Gemini CLI ou outro app MCP | Outros clientes MCP |
Primeiras perguntas seguras
- “Mostre quais capacidades do Blocchi tenho permissão para acessar e quais fontes de dados faltam antes de calcular métricas.”
- “Resuma meu pipeline de receita autorizado, incluindo evidências e atualização dos dados.”
- “Quais itens de trabalho precisam de decisão humana? Não execute ações.”
As respostas dependem do workspace, dos dados disponíveis e das ferramentas autorizadas; nem tudo está disponível em todos os planos.
Segurança e credenciais
- Para uso pessoal interativo, prefira OAuth se suportado pelo cliente. O Blocchi publica metadados de autorização, mas a compatibilidade depende do cliente.
- Se OAuth não funcionar, crie uma chave pessoal somente leitura em Configurações de desenvolvedor e armazene-a apenas nas configurações seguras do conector. Nunca cole segredos no chat, em prompts, imagens ou arquivos compartilhados do repositório.
- Administradores podem criar credenciais de serviço. Automações não assistidas devem usar o contrato de Identidades de automação, com escopos, limites e revisão humana.
- Antes de alterar registros ou enviar mensagens, revise o alvo, a aprovação e os efeitos. Conectar não concede execução irrestrita.
- Desconecte ou revogue credenciais que não estiver mais usando.
Problemas comuns
| Sintoma | O que verificar |
|---|---|
| Ferramentas não aparecem | URL exata /api/mcp, HTTPS e suporte a MCP remoto via Streamable HTTP. |
| Falha de OAuth | O cliente pode não aceitar a identificação de cliente / redirecionamento OAuth publicado pelo Blocchi. Use autenticação suportada ou peça a um admin uma integração compatível. Nunca desative a autenticação. |
401 | Token ausente, vencido ou revogado. Faça login novamente ou troque a credencial limitada. |
403 ou ferramenta ausente | Papel, escopo, produto, fonte ou política não permitem o acesso. Não contorne a regra. |
| Resposta vazia ou antiga | Confira conexão, sincronização, mapeamento semântico e atualização em Fontes de dados. |
| Não consegue escrever | Esperado quando o acesso é somente leitura, exige aprovação ou a ação não é suportada. Use ações governadas. |
Veja também a referência MCP, API vs MCP e a documentação oficial de cada cliente.
As telas dos fornecedores mudam. Os guias apontam para a ajuda oficial. Não anunciamos listagem em diretório nem conexão de um clique sem certificação.
Última atualização em