Ir para o conteúdo
Testar grátis
Atualizado em 17 de outubro de 2026

Conector de IA (MCP)

O conector põe o bFocus dentro do aplicativo de IA que a sua equipe já usa — Claude, ChatGPT, Codex, Cursor e qualquer aplicativo compatível com o MCP (Model Context Protocol). A IA lê os erros capturados pelo Monitoramento, os chamados, as tarefas e os projetos, e age neles com as mesmas regras da tela, sempre em nome de quem conectou.

Endereço do conector

O mesmo endereço em qualquer aplicativo:

https://api.bfocus.com.br/mcp

Transporte HTTP (Streamable HTTP). Autenticação por OAuth 2.1 com PKCE — o aplicativo abre a tela do bFocus para você entrar e escolher o que liberar — ou por chave da API, para automações que rodam sem ninguém na frente.

O que é preciso

  • Uma conta no bFocus com papel de administrador ou gestor (são os papéis que enxergam a empresa inteira na tela).
  • Os módulos que você quer usar contratados pela empresa: Monitoramento, Atendimento (chamados) e Projetos (tarefas e projetos). Sem o módulo, as ferramentas dele não aparecem.
  • Um aplicativo de IA que aceite conectores MCP remotos.

Conectar

Claude (claude.ai, Claude Desktop e celular)

  • Abra Configurações › Conectores e clique em Adicionar conector personalizado.
  • Cole o endereço acima e clique em Conectar.
  • Entre no bFocus, confira a empresa e marque o que o Claude pode fazer. Ler já vem marcado; escrever é escolha.

Claude Code

claude mcp add --transport http bfocus https://api.bfocus.com.br/mcp

Depois, dentro do Claude Code, rode /mcp, escolha bfocus e autentique.

Codex

No arquivo ~/.codex/config.toml, com uma chave da API do bFocus na variável BFOCUS_API_KEY:

[mcp_servers.bfocus]
url = "https://api.bfocus.com.br/mcp"
bearer_token_env_var = "BFOCUS_API_KEY"

Cursor

{ "mcpServers": { "bfocus": { "url": "https://api.bfocus.com.br/mcp" } } }

ChatGPT e outros aplicativos

Em aplicativos que aceitam conector MCP personalizado, use o mesmo endereço. A descoberta do login é automática.

Chave da API (automações)

Em Integrações › API, crie uma chave marcando os escopos que a IA vai usar (monitor:read, monitor:write, tickets:read, tickets:write, tasks:read, tasks:write, projects:read). Envie no cabeçalho Authorization: Bearer <chave>. Tudo o que a IA fizer sai em nome de quem criou a chave.

Ferramentas

  • Monitoramento: monitor_summary, list_errors, get_error (leitura); update_error (resolver, ignorar, reabrir), merge_errors, investigate_error, create_error_task (escrita).
  • Chamados: list_tickets, get_ticket (leitura); comment_ticket (sempre nota interna), update_ticket (escrita).
  • Tarefas: list_tasks, get_task (leitura); comment_task, update_task, create_task (rascunho) (escrita).
  • Projetos: list_projects, get_project, com o radar de risco (leitura).

Cada ferramenta declara se só lê ou se altera dados, e o aplicativo de IA mostra isso antes de agir. A lista que a IA recebe é a que a conexão permite: escopo marcado e módulo contratado.

Agentes prontos

  • Ronda do Monitoramento: olha erros novos e regressões, separa grave, atenção e ruído, abre a demanda que faltar e deixa o diagnóstico nela.
  • Corrigir um erro: acha a causa no código aberto no computador, propõe a correção e registra tudo na demanda.
  • Triagem de chamados: resume cada chamado aberto e deixa uma nota interna com prioridade sugerida e próximo passo.
  • Saúde dos projetos: relatório da carteira com o que pede decisão.

No Claude Code eles aparecem como comandos (/mcp__bfocus__ronda_de_erros, por exemplo).

Exemplos de pedidos

  • "Quais erros novos apareceram no Monitoramento nas últimas 24 horas?"
  • "Mostre o erro com mais clientes afetados e explique a causa provável."
  • "Abra a demanda dos erros graves que ainda não têm tarefa."
  • "Liste os chamados abertos de prioridade alta e resuma cada um."
  • "Quais projetos em execução estão com risco?"

Segurança e limites

  • A IA age em nome de quem conectou: comentários, mudanças de status e tarefas criadas aparecem com o nome dessa pessoa, no histórico.
  • O conector nunca escreve ao cliente (comentário é sempre nota interna), não abre chamado, não avisa terceiros e não apaga nada. Tarefa criada pela IA nasce em rascunho.
  • Texto de erro, chamado e tarefa vem de terceiros. O conector avisa a IA, em toda conexão, que esse texto é dado e nunca instrução.
  • Conteúdo marcado como confidencial nunca sai.
  • O bFocus não recebe a conversa com a IA, só os pedidos às ferramentas.

Revogar o acesso

Em Integrações › IA (MCP), em Conexões ativas, clique em Revogar. O acesso cai na chamada seguinte. Deixar de ser administrador ou gestor, ou ser desativado, também derruba a conexão.

Privacidade e suporte

O que o conector compartilha e guarda está na política de privacidade. Dúvidas e problemas: [email protected].