MCP

Conecta clientes de IA compatibles con MCP a Fluxo para que los agentes puedan leer el contexto de soporte al que ya tiene acceso la persona de tu equipo con la sesión iniciada.

Endpoint:

Copiarhttps://api.fluxo.lat/mcp

El servidor MCP alojado usa MCP por HTTP remoto con OAuth. Tu cliente abrirá un inicio de sesión en el navegador cuando haga falta autenticarse. No pegues una clave de API de Fluxo, un token bearer ni un secreto de cliente en la configuración de MCP.

El acceso está limitado a tu cuenta de Fluxo. Los agentes solo pueden leer los sitios web y los datos de soporte disponibles para la persona que inicia sesión. OAuth solicita el ámbito support:read.

Instalación

Cursor

Crea o actualiza .cursor/mcp.json en tu proyecto, o ~/.cursor/mcp.json para una configuración global:

Copiar{
  "mcpServers": {
    "fluxo": {
      "url": "https://api.fluxo.lat/mcp"
    }
  }
}

Reinicia Cursor o recarga MCP después de guardar el archivo. Cuando Cursor pida autenticación, completa el inicio de sesión en el navegador.

Claude Code

Copiarclaude mcp add --transport http fluxo https://api.fluxo.lat/mcp

Después abre Claude Code y ejecuta:

Copiar/mcp

Usa la vista de estado de MCP para autenticarte con Fluxo en el navegador.

OpenCode

Añade Fluxo a opencode.json:

Copiar{
  "$schema": "https://opencode.ai/config.json",
  "mcp": {
    "fluxo": {
      "type": "remote",
      "url": "https://api.fluxo.lat/mcp",
      "enabled": true
    }
  }
}

Reinicia OpenCode o recarga MCP para que descubra el nuevo servidor.

Manual

Para clientes que aceptan un objeto mcpServers, usa:

Copiar{
  "mcpServers": {
    "fluxo": {
      "type": "http",
      "url": "https://api.fluxo.lat/mcp"
    }
  }
}

Algunos clientes llaman streamable-http al transporte HTTP remoto. Mantén la misma URL si tu cliente usa ese nombre.

Qué pueden hacer los agentes

Las primeras herramientas MCP de Fluxo son de solo lectura:

Todavía no se exponen herramientas de escritura como responder, resolver o cambiar la prioridad.

Entradas y salidas de las herramientas

Selecciona un sitio web con exactamente uno de websiteId o el websiteName exacto en todas las herramientas salvo fluxo_list_websites.

Los errores de las herramientas se devuelven como errores MCP, sin detalles internos de la base de datos. Un selector de sitio web ausente o ambiguo, un recurso inaccesible, un cursor no válido o una sesión de OAuth caducada hay que corregirlos, no reintentarlos a ciegas.

Ahora mismo el endpoint alojado permite 60 peticiones HTTP de MCP por minuto y por IP o sujeto autenticado. Respeta las cabeceras de límite de uso y reintenta tras la ventana que indique el servidor; no ejecutes paginación paralela sin límite.

Pruébalo

Pídele a tu agente:

CopiarList my Fluxo websites.

CopiarSearch Acme Support knowledge for billing cancellation.

CopiarShow recent open conversations for Acme Support.

CopiarOpen conversation <conversationId> and summarize the latest customer issue.

Resolución de problemas

• Vuelve a conectar o recarga MCP después de editar la configuración.
• Usa la vista de estado de MCP de tu cliente para completar el OAuth.
• Confirma que has iniciado sesión con una cuenta de Fluxo que tenga acceso al sitio web.
• Quita cualquier cabecera Authorization si el OAuth no arranca.
• En OpenCode, usa opencode mcp list, opencode mcp debug y opencode mcp logout fluxo para inspeccionar o limpiar la autenticación.
• En Claude Code, abre /mcp para inspeccionar el servidor y limpiar o rehacer la autenticación.
• En Cursor, usa sus controles de estado e inicio de sesión de MCP tras recargar la configuración.
• Revoca el acceso cerrando la sesión del servidor de Fluxo en el cliente o revocando la sesión de OAuth correspondiente en los ajustes de seguridad de tu cuenta.