El Fin Agent API expone un servidor remoto Model Context Protocol (MCP) que permite a agentes externos de IA usar Fin como herramienta. En lugar de reconstruir la lógica de soporte en tu propio agente, puedes conectar la knowledge base, procedimientos y capacidades de conversación multi-turno de Fin directamente desde cualquier cliente compatible con MCP, incluyendo Claude, Claude Code, Cursor o tu propio framework de agente.

¿Quieres configurar o ajustar tu espacio de trabajo desde Claude Code? Este servidor MCP permite que un agente use Fin (hacer preguntas, mantener conversaciones y ejecutar procedimientos). No cambia tu configuración de Intercom ni de Fin. Para crear, configurar o gestionar tu espacio de trabajo desde Claude Code u otro agente de codificación IA (por ejemplo, procedimientos, guías, audiencias, conectores de datos, workflows, el Messenger o artículos del Help Center), usa el Fin CLI.

Casos de uso

El Fin Agent API MCP server está diseñado para escenarios multi-agente donde tu propio agente necesita acceso a las capacidades de Fin:

Soporte integrado en agentes de producto. Da a tu asistente de IA del producto la capacidad de responder preguntas de soporte usando tu knowledge base configurada en Fin, sin duplicar tu knowledge base o contenido.
Automatización de procedimientos. Permite que un agente orquestador active procedimientos de Fin (reembolsos, actualizaciones, cancelaciones) en nombre de users y maneje interacciones multi-turno programáticamente.
Enrutamiento basado en capacidades. Usa list_fin_capabilities para determinar qué acciones están disponibles para un user dado, luego enruta a la herramienta correcta en la lógica de decisión de tu agente.
Herramientas para desarrolladores. Muestra tu knowledge base de Fin dentro de herramientas para desarrolladores como Claude Code o Cursor, para que los users internos puedan consultar tu contenido de soporte desde su workflow existente. Para configurar Fin o tu espacio de trabajo desde estas herramientas, usa el Fin CLI.

Requisitos previos

Tu espacio de trabajo Fin debe tener la clave Fin Agent API generada y disponible.

Punto final

https://api.intercom.io/fin/mcp

Usa esto cuando un servicio backend confiable esté llamando a Fin en nombre de un user. El llamador se autentica con la clave Fin Agent API del espacio de trabajo. La identidad del usuario final se suministra en el cuerpo de la solicitud por el servicio llamador. Este modelo es apropiado para integraciones servidor a servidor donde tu backend controla quién hace la solicitud.

Autenticación

Pasa tu clave Fin Agent API api como token Bearer en el encabezado Authorization:

Authorization: Bearer YOUR_FIN_AGENT_API_KEY

Conexión desde Claude

Claude Desktop

Agrega lo siguiente a tu claude_desktop_config.json:

{
  "mcpServers": {
    "fin": {
      "command": "npx",
 "args": [
   "-y",
   "mcp-remote",
    "https://api.intercom.io/fin/mcp",
   "--header",
        "Authorization: Bearer {YOUR_FIN_AGENT_API_KEY}"
      }
    }
  }
}

Claude Code (CLI)

claude mcp add intercom-fin \
  --transport http \
  https://api.intercom.io/fin/mcp \
  --header "Authorization: Bearer YOUR_FIN_AGENT_API_KEY"

Herramientas

Una vez conectado, el servidor MCP expone cinco herramientas al cliente.

list_fin_capabilities

Devuelve las capacidades Fin Agent API disponibles para un user dado: los procedimientos coincidentes con la audiencia que el user puede activar, más las acciones estáticas disponibles para todos los users (hacer una pregunta, responder a una conversación).

Llama a esto primero para descubrir qué puede hacer Fin para un user específico antes de usar otras herramientas. El acceso a procedimientos está basado en audiencia: no todos los users tienen acceso a todos los procedimientos.

Entrada: user_id — el ID externo del user.

Devuelve: Un documento JSON que lista las capacidades disponibles, cada una con su tipo, ID y nombre.

ask_fin

Envía una pregunta puntual a Fin y devuelve una respuesta. Fin busca en tus fuentes de conocimiento configuradas y devuelve una respuesta directa sin iniciar una conversación persistente.

Usa esto para consultas informativas donde quieres una respuesta directa y no necesitas un flujo multi-turno.

Entradas: user_id, message (la pregunta a hacer).

get_fin_response

Consulta la respuesta de Fin a una conversación o flujo de procedimiento en curso. Usa esto después de iniciar una conversación o procedimiento para obtener la última respuesta de Fin.

Entrada: conversation_id.

reply_to_fin_conversation

Envía un mensaje de seguimiento en una conversación Fin existente. Usa esto para continuar una interacción multi-turno — por ejemplo, proporcionando información adicional que Fin solicitó durante un procedimiento.

Entradas: conversation_id, message.

run_fin_procedure

Activa un procedimiento Fin específico para un user. Un procedimiento es un workflow multi-paso configurado — por ejemplo, procesar un reembolso o actualizar una suscripción. Fin iniciará el procedimiento, puede pedir información adicional y conducirá la interacción hasta completarla.

Usa list_fin_capabilities primero para encontrar el ID del procedimiento para la acción que quieres ejecutar.

Entradas: procedure_id, user_id.

Fin Agent API: Servidor MCP