Le Fin Agent API expose un serveur distant Model Context Protocol (MCP) qui permet aux agents IA externes d'appeler Fin comme un outil. Au lieu de reconstruire la logique de support dans votre propre agent, vous pouvez connecter directement la knowledge base, les procédures et les capacités de conversation multi-tours de Fin depuis n'importe quel client compatible MCP, y compris Claude, Claude Code, Cursor ou votre propre framework d'agent.

Vous souhaitez configurer ou paramétrer votre espace de travail depuis Claude Code ? Ce serveur MCP permet à un agent d'utiliser Fin (poser des questions, tenir des conversations et exécuter des procédures). Il ne modifie pas votre configuration Intercom ou Fin. Pour créer, configurer ou gérer votre espace de travail depuis Claude Code ou un autre agent IA de codage (par exemple procédures, guidance, audiences, connecteurs de données, workflows, Messenger ou articles du Help Center), utilisez plutôt le Fin CLI.

Cas d'utilisation

Le serveur Fin Agent API MCP est conçu pour des scénarios multi-agents où votre propre agent doit accéder aux capacités de Fin :

Support intégré dans les agents produits. Donnez à l'assistant IA de votre produit la capacité de répondre aux questions de support en utilisant votre knowledge base Fin configurée, sans dupliquer votre knowledge base ou contenu.
Automatisation des procédures. Permettez à un agent orchestrateur de déclencher des procédures Fin (remboursements, mises à niveau, annulations) au nom des users et de gérer les interactions multi-tours de manière programmatique.
Routage basé sur les capacités. Utilisez list_fin_capabilities pour déterminer quelles actions sont disponibles pour un user donné, puis orientez vers le bon outil dans la logique décisionnelle de votre agent.
Outils pour développeurs. Affichez votre knowledge base Fin dans des outils pour développeurs comme Claude Code ou Cursor, afin que les users internes puissent interroger votre contenu de support depuis leur workflow existant. Pour configurer Fin ou votre espace de travail depuis ces outils, utilisez le Fin CLI.

Prérequis

Votre espace de travail Fin doit avoir la clé Fin Agent API générée et disponible.

Point de terminaison

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

Utilisez ceci lorsqu'un service backend de confiance appelle Fin au nom d'un user. L'appelant s'authentifie avec la clé Fin Agent API de l'espace de travail. L'identité de l'utilisateur final est fournie dans le corps de la requête par le service appelant. Ce modèle convient aux intégrations serveur-à-serveur où votre backend contrôle qui fait la requête.

Authentification

Passez votre clé Fin Agent API api comme jeton Bearer dans l'en-tête Authorization :

Authorization: Bearer YOUR_FIN_AGENT_API_KEY

Connexion depuis Claude

Claude Desktop

Ajoutez ce qui suit à votre 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"

Outils

Une fois connecté, le serveur MCP expose cinq outils au client.

list_fin_capabilities

Retourne les capacités Fin Agent API disponibles pour un user donné : les procédures correspondant à l'audience que l'user peut déclencher, plus les actions statiques disponibles pour tous les users (poser une question, répondre à une conversation).

Appelez ceci en premier pour découvrir ce que Fin peut faire pour un user spécifique avant d'appeler d'autres outils. L'accès aux procédures est adapté à l'audience — tous les users n'ont pas accès à toutes les procédures.

Entrée : user_id — l'ID externe de l'user.

Retourne : Un document JSON listant les capacités disponibles, chacune avec son type, ID et nom.

ask_fin

Envoie une question ponctuelle à Fin et retourne une réponse. Fin recherche dans vos sources de knowledge configurées et renvoie une réponse directe sans démarrer une conversation persistante.

Utilisez ceci pour des recherches d'information où vous souhaitez une réponse directe et n'avez pas besoin de flux multi-tours.

Entrées : user_id, message (la question à poser).

get_fin_response

Interroge la réponse de Fin à une conversation ou un flux de procédure en cours. Utilisez ceci après avoir démarré une conversation ou une procédure pour récupérer la dernière réponse de Fin.

Entrée : conversation_id.

reply_to_fin_conversation

Envoie un message de suivi dans une conversation Fin existante. Utilisez ceci pour continuer une interaction multi-tours — par exemple, fournir des informations supplémentaires que Fin a demandées pendant une procédure.

Entrées : conversation_id, message.

run_fin_procedure

Déclenche une procédure Fin spécifique pour un user. Une procédure est un workflow multi-étapes configuré — par exemple, traiter un remboursement ou mettre à jour un abonnement. Fin démarrera la procédure, pourra demander des informations supplémentaires et conduira l'interaction jusqu'à son terme.

Utilisez d'abord list_fin_capabilities pour trouver l'ID de la procédure pour l'action que vous souhaitez exécuter.

Entrées : procedure_id, user_id.

Fin Agent API : serveur MCP