MCP Intercom Server

MCP Intercom Server

Um servidor Model Context Protocol (MCP) que fornece acesso a conversas e chats do Intercom. Este servidor permite que LLMs consultem e analisem suas conversas do Intercom com várias opções de filtragem.

Recursos

• Consultar conversas do Intercom com opções de filtragem:
  • Intervalo de datas (datas de início e fim)
  • ID do cliente
  • Estado da conversa
• Acesso seguro usando sua chave da API do Intercom
• Dados ricos de conversa, incluindo:
  • Detalhes básicos da conversa
  • Informações de contato
  • Estatísticas (respostas, reaberturas)
  • Informações de estado e prioridade

Instalação

1. Clone o repositório:

git clone https://github.com/fabian1710/mcp-intercom.git
cd mcp-intercom

2. Instale as dependências:

npm install

3. Configure seu ambiente:

cp .env.example .env

4. Adicione sua chave da API do Intercom ao .env:

INTERCOM_API_KEY=your_api_key_here

5. Compile o servidor:

npm run build

Uso

Executando o Servidor

Inicie o servidor:

npm start

Usando com Claude for Desktop

1. Adicione o servidor à configuração do Claude for Desktop (~/Library/Application Support/Claude/claude_desktop_config.json no macOS ou %AppData%\Claude\claude_desktop_config.json no Windows):

{
  "mcpServers": {
    "intercom": {
      "command": "node",
      "args": ["/path/to/mcp-intercom/dist/index.js"],
      "env": {
        "INTERCOM_API_KEY": "your_api_key_here"
      }
    }
  }
}

2. Reinicie o Claude for Desktop

Ferramentas Disponíveis

search-conversations

Pesquisa conversas do Intercom com filtros opcionais.

Parâmetros:

• createdAt (opcional): Objeto com operator (ex.: ">", "<", "=") e value (timestamp UNIX) para filtrar por data de criação.
• updatedAt (opcional): Objeto com operator (ex.: ">", "<", "=") e value (timestamp UNIX) para filtrar por data de atualização.
• sourceType (opcional): Tipo de origem da conversa (ex.: "email", "chat").
• state (opcional): Estado da conversa para filtrar (ex.: "aberta", "fechada").
• open (opcional): Booleano para filtrar por status de aberta.
• read (opcional): Booleano para filtrar por status de lida.

Exemplos de consultas:

• "Pesquisar todas as conversas criadas após 1º de janeiro de 2024"
• "Encontrar conversas atualizadas antes da semana passada"
• "Listar todas as conversas de e-mail abertas"
• "Obter todas as conversas não lidas"

Segurança

• O servidor requer uma chave da API do Intercom para funcionar
• A chave da API deve ser armazenada com segurança em variáveis de ambiente
• O servidor fornece apenas acesso de leitura às conversas
• Todas as solicitações de API são feitas com autenticação adequada

Desenvolvimento

1. Inicie o modo de desenvolvimento com recompilação automática:

npm run dev

2. Execute a verificação de lint:

npm run lint

Contribuindo

1. Faça um fork do repositório
2. Crie um novo branch para sua funcionalidade
3. Faça suas alterações
4. Envie um pull request

Licença

MIT