O Fin Agent API expõe um servidor remoto Model Context Protocol (MCP) que permite que agentes externos de IA usem o Fin como uma ferramenta. Em vez de reconstruir a lógica de suporte no seu próprio agente, você pode conectar a knowledge base, procedimentos e capacidades de conversação multi-turno do Fin diretamente de qualquer cliente compatível com MCP, incluindo Claude, Claude Code, Cursor ou seu próprio framework de agente.

Quer configurar seu workspace a partir do Claude Code? Este servidor MCP permite que um agente use o Fin (faça perguntas, mantenha conversas e execute procedimentos). Ele não altera sua configuração do Intercom ou do Fin. Para criar, configurar ou gerenciar seu workspace a partir do Claude Code ou outro agente de codificação de IA (por exemplo, procedimentos, orientações, públicos, conectores de dados, workflows, o Messenger ou artigos do Help Center), use o Fin CLI.

Casos de uso

O Fin Agent API MCP server é projetado para cenários multi-agente onde seu próprio agente precisa acessar as capacidades do Fin:

Suporte incorporado em agentes de produto. Dê ao assistente de IA do seu produto a capacidade de responder perguntas de suporte usando seu conhecimento Fin configurado, sem duplicar sua knowledge base ou conteúdo.
Automação de procedimentos. Permita que um agente orquestrador acione procedimentos Fin (reembolsos, upgrades, cancelamentos) em nome dos users e gerencie interações multi-turno programaticamente.
Roteamento baseado em capacidades. Use list_fin_capabilities para determinar quais ações estão disponíveis para um determinado user, então direcione para a ferramenta certa na lógica de decisão do seu agente.
Ferramentas para desenvolvedores. Exponha seu conhecimento Fin dentro de ferramentas para desenvolvedores como Claude Code ou Cursor, para que users internos possam consultar seu conteúdo de suporte a partir do workflow existente. Para configurar o Fin ou seu workspace a partir dessas ferramentas, use o Fin CLI.

Pré-requisitos

Seu workspace Fin deve ter a chave Fin Agent API gerada e disponível.

Endpoint

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

Use isso quando um serviço backend confiável estiver chamando o Fin em nome de um user. O chamador autentica com a chave Fin Agent API do workspace. A identidade do usuário final é fornecida no corpo da requisição pelo serviço chamador. Este modelo é apropriado para integrações servidor a servidor onde seu backend controla quem está fazendo a requisição.

Autenticação

Passe sua chave Fin Agent API como token Bearer no cabeçalho Authorization:

Authorization: Bearer YOUR_FIN_AGENT_API_KEY

Conectando do Claude

Claude Desktop

Adicione o seguinte ao seu 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"

Ferramentas

Uma vez conectado, o servidor MCP expõe cinco ferramentas para o cliente.

list_fin_capabilities

Retorna as capacidades do Fin Agent API disponíveis para um determinado user: os procedimentos correspondentes ao público que o user pode acionar, além das ações estáticas disponíveis para todos os users (fazer uma pergunta, responder a uma conversa).

Chame isso primeiro para descobrir o que o Fin pode fazer por um user específico antes de chamar outras ferramentas. O acesso a procedimentos é correspondente ao público — nem todo user tem acesso a todos os procedimentos.

Entrada: user_id — o ID externo do user.

Retorna: Um documento JSON listando as capacidades disponíveis, cada uma com seu tipo, ID e nome.

ask_fin

Envia uma pergunta única para o Fin e retorna uma resposta. O Fin busca suas fontes de conhecimento configuradas e retorna uma resposta direta sem iniciar uma conversa persistente.

Use isso para consultas informativas onde você quer uma resposta direta e não precisa de fluxo multi-turno.

Entradas: user_id, message (a pergunta a ser feita).

get_fin_response

Consulta a resposta do Fin para uma conversa ou fluxo de procedimento em andamento. Use isso após iniciar uma conversa ou procedimento para recuperar a resposta mais recente do Fin.

Entrada: conversation_id.

reply_to_fin_conversation

Envia uma mensagem de acompanhamento em uma conversa Fin existente. Use isso para continuar uma interação multi-turno — por exemplo, fornecendo informações adicionais que o Fin solicitou durante um procedimento.

Entradas: conversation_id, message.

run_fin_procedure

Aciona um procedimento Fin específico para um user. Um procedimento é um workflow multi-etapas configurado — por exemplo, processar um reembolso ou atualizar uma assinatura. O Fin iniciará o procedimento, pode pedir informações adicionais e conduzirá a interação até a conclusão.

Use list_fin_capabilities primeiro para encontrar o ID do procedimento para a ação que você quer executar.

Entradas: procedure_id, user_id.

Fin Agent API: Servidor MCP