Ir al contenido
Probar gratis
Actualizado el 17 de octubre de 2026

Conector de IA (MCP)

El conector pone bFocus dentro de la app de IA que su equipo ya usa — Claude, ChatGPT, Codex, Cursor y cualquier app compatible con MCP (Model Context Protocol). La IA lee los errores capturados por el Monitoreo, los tickets, las tareas y los proyectos, y actúa sobre ellos con las mismas reglas de la pantalla, siempre en nombre de quien la conectó.

Dirección del conector

La misma dirección en cualquier app:

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

Transporte HTTP (Streamable HTTP). Autenticación con OAuth 2.1 y PKCE — la app abre la pantalla de bFocus para que usted entre y elija qué liberar — o con una clave de la API, para automatizaciones que corren sin nadie al frente.

Requisitos

  • Una cuenta en bFocus con rol de administrador o gestor (los roles que ven toda la empresa en pantalla).
  • Los módulos que quiera usar contratados por la empresa: Monitoreo, Atención (tickets) y Proyectos (tareas y proyectos). Sin el módulo, sus herramientas no aparecen.
  • Una app de IA que acepte conectores MCP remotos.

Conectar

Claude (claude.ai, Claude Desktop y móvil)

  • Abra Configuración › Conectores y haga clic en Agregar conector personalizado.
  • Pegue la dirección de arriba y haga clic en Conectar.
  • Entre en bFocus, verifique la empresa y marque lo que Claude puede hacer. Leer viene marcado; escribir es una elección.

Claude Code

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

Después, dentro de Claude Code, ejecute /mcp, elija bfocus y autentíquese.

Codex

En ~/.codex/config.toml, con una clave de la API de bFocus en la variable 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 y otras apps

En apps que aceptan un conector MCP personalizado, use la misma dirección. El descubrimiento del inicio de sesión es automático.

Clave de la API (automatizaciones)

En Integraciones › API, cree una clave con los alcances que la IA usará (monitor:read, monitor:write, tickets:read, tickets:write, tickets:reply, tasks:read, tasks:write, projects:read, release_notes:read, release_notes:write). Envíela en el encabezado Authorization: Bearer <clave>. Todo lo que la IA haga sale a nombre de quien creó la clave.

Más de una empresa

  • Un conector para todas: en la pantalla de autorización, marque las empresas donde su correo es administrador o gestor. Las herramientas pasan a recibir la empresa, y list_companies muestra cuáles están conectadas.
  • Un conector por empresa: use https://api.bfocus.com.br/mcp/<empresa> (aparece en Integraciones › IA (MCP) de cada empresa). Cada dirección se vuelve un conector separado en la app y solo alcanza esa empresa.

Herramientas

  • Monitoreo: monitor_summary, list_errors, get_error (lectura); update_error (resolver, ignorar, reabrir), merge_errors, investigate_error, create_error_task (escritura).
  • Tickets: list_tickets, get_ticket (lectura); comment_ticket (nota interna), update_ticket, reply_ticket (respuesta al cliente, con permiso propio) (escritura).
  • Tareas: list_tasks, get_task (lectura); comment_task, update_task, create_task (borrador) (escritura).
  • Proyectos: list_projects, get_project, con el radar de riesgo (lectura).
  • Novedades (release notes): list_release_notes, get_release_note (lectura); save_release_note_draft (crea y edita borradores; publicar queda en la consola).

Cada herramienta declara si solo lee o si cambia datos, y la app de IA lo muestra antes de actuar. La IA recibe solo las herramientas que la conexión permite: alcance marcado y módulo contratado.

Agentes listos

  • Ronda del Monitoreo: revisa errores nuevos y regresiones, separa grave, atención y ruido, abre la demanda que falte y deja el diagnóstico en ella.
  • Corregir un error: encuentra la causa en el código abierto en la computadora, propone la corrección y registra todo en la demanda.
  • Triaje de tickets: resume cada ticket abierto y deja una nota interna con prioridad sugerida y próximo paso.
  • Salud de los proyectos: informe de la cartera con lo que pide decisión.

En Claude Code aparecen como comandos (por ejemplo /mcp__bfocus__ronda_de_erros).

Ejemplos de pedidos

  • "¿Qué errores nuevos aparecieron en el Monitoreo en las últimas 24 horas?"
  • "Muestre el error con más clientes afectados y explique la causa probable."
  • "Abra la demanda de los errores graves que aún no tienen tarea."
  • "Liste los tickets abiertos de prioridad alta y resuma cada uno."
  • "¿Qué proyectos en ejecución están en riesgo?"

Seguridad y límites

  • La IA actúa en nombre de quien conectó: comentarios, cambios de estado y tareas creadas aparecen con el nombre de esa persona en el historial.
  • Responder al cliente exige el permiso propio Responder al cliente, desmarcado en la autorización; sin él, el comentario es siempre nota interna. El conector no abre tickets, no avisa a terceros y no borra nada. La tarea creada por la IA nace como borrador.
  • El texto de errores, tickets y tareas viene de terceros. En cada conexión el conector avisa a la IA que ese texto es dato y nunca instrucción.
  • El contenido marcado como confidencial nunca sale.
  • bFocus no recibe la conversación con la IA, solo los pedidos a las herramientas.

Revocar el acceso

En Integraciones › IA (MCP), en Conexiones activas, haga clic en Revocar. El acceso cae en la llamada siguiente. Dejar de ser administrador o gestor, o ser desactivado, también termina la conexión.

Privacidad y soporte

Lo que el conector comparte y guarda está en la política de privacidad. Dudas y problemas: [email protected].