jrbrollo/rd-station-mcp-server

Servidor MCP para RD Station

Este é um servidor MCP (Model Context Protocol) customizado que permite integrar o RD Station CRM com agentes de IA, como o GPT Maker.

Funcionalidades

• ✅ Criar contatos no RD Station
• ✅ Buscar contatos por email
• ✅ Criar negociações (deals)
• ✅ Listar funis (pipelines) disponíveis
• ✅ Listar etapas de funis
• ✅ Buscar negociações de contatos
• ✅ Testar conexão com a API

Instalação

1. Clone ou baixe este projeto

2. Instale as dependências:

   npm install
   

3. Configure as variáveis de ambiente:

   • Copie o arquivo env.example para .env
   • Edite o arquivo .env e adicione seu token de API do RD Station:

   RD_STATION_API_TOKEN=seu_token_aqui
   

4. Compile o projeto:

   npm run build
   

Como obter o token de API do RD Station

1. Acesse o RD Station
2. Vá em Configurações > Integrações > API
3. Gere um novo token de API
4. Copie o token e cole no arquivo .env

Como usar no GPT Maker

1. Configure o servidor MCP no GPT Maker:

   • Nome: rd-station-mcp
   • Comando: node
   • Argumentos: dist/index.js
   • Diretório de trabalho: caminho para este projeto

2. Teste a conexão:

   • Use a ferramenta test_connection para verificar se está funcionando

Ferramentas disponíveis

1. create_contact

Cria um novo contato no RD Station.

Parâmetros obrigatórios:

• name: Nome do contato
• email: Email do contato

Parâmetros opcionais:

• phone: Telefone
• company: Empresa
• job_title: Cargo
• city: Cidade
• state: Estado
• tags: Array de tags

2. get_contact

Busca um contato por email.

Parâmetros:

• email: Email do contato

3. create_deal

Cria uma nova negociação.

Parâmetros obrigatórios:

• name: Nome da negociação
• contact_email: Email do contato
• deal_stage_id: ID da etapa do funil
• deal_pipeline_id: ID do funil

Parâmetros opcionais:

• contact_name: Nome do contato
• contact_phone: Telefone do contato
• value: Valor da negociação
• currency: Moeda (padrão: BRL)
• expected_close_date: Data esperada de fechamento
• tags: Array de tags

4. get_pipelines

Lista todos os funis disponíveis.

5. get_pipeline_stages

Lista as etapas de um funil específico.

Parâmetros:

• pipeline_id: ID do funil

6. get_contact_deals

Lista as negociações de um contato.

Parâmetros:

• contact_email: Email do contato

7. test_connection

Testa a conexão com a API do RD Station.

Exemplo de uso no GPT Maker

Quando um lead conversa no WhatsApp, o agente pode:

1. Qualificar o lead:

   "Vou criar seu contato no nosso sistema..."
   

2. Criar o contato:

   • Use create_contact com os dados coletados

3. Criar uma negociação:

   • Use get_pipelines para ver os funis disponíveis
   • Use get_pipeline_stages para ver as etapas
   • Use create_deal para criar a negociação

Desenvolvimento

Para desenvolvimento local:

# Modo de desenvolvimento (recompila automaticamente)
npm run dev

# Compilar uma vez
npm run build

# Executar
npm start

Estrutura do projeto

├── src/
│   ├── index.ts          # Servidor MCP principal
│   └── rdStationClient.ts # Cliente para API do RD Station
├── dist/                 # Código compilado
├── package.json
├── tsconfig.json
├── env.example
└── README.md

Suporte

Para dúvidas ou problemas, verifique:

1. Se o token de API está correto
2. Se as dependências foram instaladas
3. Se o projeto foi compilado
4. Se o servidor MCP está configurado corretamente no GPT Maker