Guias de integração
Guia da API do LinkedIn
Guia da API de e-mail
Guia da API do WhatsApp
Fale com vendas
Cursor · MCP Server
Cursor MCP Server: mensageria e e-mail na sua IDE
Uma URL e um header adicionam o Servidor MCP da Unipile ao Cursor. Seu agente então cria recursos de LinkedIn, WhatsApp e e-mail no seu projeto e testa cada chamada na sua aplicação Development. Nada para instalar ou rodar localmente.
Teste grátis de 7 dias, sem cartão de crédito.
Cursor · crm-app
Unipile MCP conectado
Adicione a conexão de contas do LinkedIn ao meu CRM.
Ler endpointPOST /v2/auth/linkschema carregado
Adicionei a rota de conexão e o botão em Configurações. O ID da conta fica salvo no usuário.
Descreva o próximo recurso…
Caso de uso
Adicione LinkedIn, WhatsApp e e-mail ao seu produto pelo Cursor
Adicione LinkedIn, WhatsApp, e-mail ou calendário ao seu produto. Pelo servidor MCP da Unipile, o Cursor lê a referência da API, escreve o código na sua stack e testa cada requisição.
Conecte o servidor MCP da Unipile ao CursorUnipile MCP conectado
Selecione os canais que quer conectar
developer.unipile.com/mcpConectar todos os canais10 canais
↑↓navegar espaçoselecionar ↵conectaruma URL, um header
mcp.json, global ou por projeto
Adicione o servidor MCP da Unipile ao Cursor
O servidor é remoto: uma URL via streamable HTTP e um header, nada para rodar localmente. Escolha global ou projeto, cole o bloco, salve, e o Cursor o carrega.
Antes de começar: Cursor atualizado, uma aplicação Development no dashboard da Unipile com uma chave de API de conta com escopo, e uma conta de teste vinculada pelo Hosted Auth.
Configuração global~/.cursor/mcp.json
Configuração por projeto.cursor/mcp.json (raiz do repositório)
Chave vinda de uma variável de ambiente${env:UNIPILE_API_KEY}
?
Global ou por projeto?Projeto quando cada repositório precisa da própria chave com escopo. O Cursor lê primeiro o projeto, depois o global.
{
"mcpServers": {
"unipile": {
"url": "https://developer.unipile.com/mcp?branch=v2.0",
"headers": {
"X-API-KEY": "your-scoped-api-key"
}
}
}
}
{
"mcpServers": {
"unipile": {
"url": "https://developer.unipile.com/mcp?branch=v2.0",
"headers": {
"X-API-KEY": "your-scoped-api-key"
}
}
}
}
{
"mcpServers": {
"unipile": {
"url": "https://developer.unipile.com/mcp?branch=v2.0",
"headers": {
"X-API-KEY": "${env:UNIPILE_API_KEY}"
}
}
}
}
Salve o arquivo e o Cursor carrega o servidor. ${env:NAME} funciona em url e headers, então a chave nunca fica no arquivo.
Verifique a conexão
- 1Abra Customize na barra lateral: o servidor unipile aparece na lista, habilitado.
- 2No Cursor CLI, execute
agent mcp list, ou/mcp listdentro de uma sessão. - 3Em um chat, peça
Usando o Unipile MCP, liste os endpoints de busca de pessoas no LinkedIn e os parâmetros obrigatórios de cada ume espere rotas reais como resposta.
Opcional: instale com um clique
Cole sua chave de API de conta com escopo para gerar um link que abre o Cursor com o servidor pré-preenchido. A chave nunca sai do seu navegador.
Adicionar a Unipile ao Cursor
Prompts, não código de cola
Entregue o prompt ao seu agente
Três tarefas de integração, cada uma com o prompt para colar no Cursor, os endpoints que o agente executa em
https://api.unipile.com com seu X-API-KEY, e o que chega ao seu projeto.Adicione mensageria do LinkedIn ao meu ATS: sincronize a inbox de cada recrutador e deixe que respondam a partir da página do candidato.
Buscar endpoints"chats messages send"3 resultados
Executar requisiçãoGET /v2/{account_id}/chats12 chats
Criei
linkedin/inbox-sync.ts (chats e mensagens salvos no candidato, paginação por cursor) e POST /candidates/:id/reply, que chama a rota de envio com o ID da própria conta do chat. Rodei a sincronização na aplicação Development: 12 chats, 87 mensagens.Cole o prompt, revise o diff
O Cursor lê os contratos de chat e de mensagem, escreve o job de sincronização e o endpoint de resposta, e executa as primeiras requisições na sua aplicação Development. WhatsApp, Instagram, Facebook e Telegram usam as mesmas rotas de chat.
Endpoints usados pelo agente
Criar uma integração LinkedIn
GET/v2/{account_id}/chatsGET/v2/{account_id}/chats/{chat_id}/messagesPOST/v2/{account_id}/chats/{chat_id}/messages/send
Implemente o Unipile Hosted Auth neste app React e Fastify para que os usuários conectem a própria conta do LinkedIn nas configurações.
Ler endpointPOST /v2/auth/linkschema carregado
Executar requisiçãoPOST /v2/auth/link201 · link
Adicionei
POST /api/accounts/connect no Fastify: ele cria o link de autenticação no servidor e devolve a URL hospedada. A página de configurações em React o abre e, no retorno, guarda o novo account_id no workspace. Verificado na aplicação Development com uma conta de teste do LinkedIn.Seus usuários conectam as próprias contas, seu app recebe um ID de conta
O Hosted Auth é a página que a Unipile serve para que seus usuários vinculem as próprias contas. O agente monta o link no seu backend, o redirect no seu frontend e o armazenamento do ID da conta.
Endpoints usados pelo agente
Implementar o Hosted Auth com um agente
POST/v2/auth/linkPOST/v2/auth/intentGET/v2/accounts/{account_id}
Assine os webhooks de nova mensagem e crie uma inbox unificada de LinkedIn, WhatsApp e e-mail, uma única lista de threads com o canal como badge.
Ler endpointPOST /v2/webhooks/endpoints/schema carregado
Executar requisiçãoGET /v2/{account_id}/emails200 OK
Registrei um endpoint de webhook para eventos de mensagem na aplicação Development, adicionei
POST /webhooks/unipile que devolve 200 na hora e enfileira o evento, um modelo Thread que mapeia chats e threads de e-mail para um mesmo formato, e a lista de threads com badges de canal. Enviei uma mensagem de teste: a lista atualizou em menos de um segundo.Tempo real sem polling, uma lista para mensageria e e-mail
O agente lê os contratos de chat e de e-mail, desenha um modelo único de thread e escreve a sincronização e o receptor de webhook. Depois confere o log de entregas pela rota de conversas do webhook.
Endpoints usados pelo agente
Criar uma inbox unificada com um agente
POST/v2/webhooks/endpoints/GET/v2/{account_id}/chatsGET/v2/{account_id}/emailsGET/v2/webhooks/conversations/
Uma aplicação Development primeiro
Dê ao Cursor uma chave com escopo de uma aplicação Development, separada da Production.
Contas de teste, requisições reais
O agente executa requisições em contas de teste, em nome do usuário autenticado que as vinculou, dentro dos limites de cada provedor.
Valide cada fluxo
Confira o fluxo de conexão, uma leitura e uma escrita por recurso, e uma entrega de webhook.
Depois passe para Production
Nada toca nas contas dos seus usuários até você trocar a chave. Veja segurança e compliance.
Solução de problemas
Erros comuns e o que eles significam
As mensagens que o Cursor mostra quando uma entrada MCP não está certa, e a correção de cada uma.
No tools or prompts
Confira o arquivo que você editou (~/.cursor/mcp.json ou .cursor/mcp.json), remova qualquer vírgula sobrando no final e recarregue o servidor em Customize.
No server info found
Use uma entrada remota com url definido exatamente como https://developer.unipile.com/mcp?branch=v2.0 e headers, sem command ou type: "stdio".
Connection failed
Confira o host e ?branch=v2.0 em busca de erro de digitação, ou um proxy corporativo: a URL precisa responder no navegador, não 404.
401 Unauthorized nas requisições
Envie uma chave de API de conta com escopo da sua aplicação Development em headers, com o nome exato X-API-KEY.
A configuração de projeto é ignorada
Coloque .cursor/mcp.json na raiz da pasta que você abriu no Cursor, não em uma subpasta.
Onde ler os logs
Abra o painel Output (Cmd+Shift+U no macOS, Ctrl+Shift+U no Windows e no Linux) e selecione MCP Logs no menu suspenso.
6000+
Empresas que inovam com a Unipile
Com a confiança dos líderes do setor
1 API
Simplificar as operações de todos os principais canais de comunicação
2 dias
Obtenha integração ao vivo rapidamente com o mínimo de configuração
30%
Redução dos esforços e recursos de manutenção
Segurança e conformidade incorporadas
Proteção de nível empresarial para seus dados e fluxos de trabalho Saiba mais sobre nossa segurança
SOC 2 Tipo II
Certificado
Controles de segurança auditados de forma independente, garantindo a proteção dos dados e a integridade operacional.
GDPR
Em conformidade
Conformidade total com os regulamentos europeus de proteção de dados para a privacidade do usuário.
99.9%
Tempo de atividade da plataforma nos últimos 24 meses
24/7
Suporte global com API de alto desempenho
FAQ do servidor MCP no Cursor
As perguntas que as pessoas realmente digitam: onde fica o mcp.json, global ou por projeto, servidores remotos e headers, o que checar quando nada aparece, chaves, instalação em um clique e o CLI.
Em dois lugares.
~/.cursor/mcp.json na sua pasta pessoal é a configuração global, disponível em todos os projetos. .cursor/mcp.json na raiz da pasta que você abriu no Cursor é a configuração do projeto. O Cursor lê primeiro o arquivo do projeto, depois o global e depois os diretórios pai. Os dois aceitam o bloco mcpServers no mesmo formato.Globalmente quando você constrói várias integrações Unipile em uma máquina e uma aplicação Development. Por projeto quando cada repositório precisa da própria chave com escopo, que é a escolha certa quando as integrações de Development e de Production ficam em repositórios diferentes. Nos dois casos a chave é uma chave de API de conta com escopo, nunca uma chave Service ou global.
Sim. Uma entrada remota em
mcp.json aceita uma url e um objeto headers e o Cursor resolve ${env:NAME} nos dois. O servidor da Unipile é exatamente isso: streamable HTTP em https://developer.unipile.com/mcp?branch=v2.0 com o X-API-KEY como header. Sem npx, sem processo local, sem versão de Node para gerenciar.Nesta ordem: o arquivo que você editou (global ou de projeto, na raiz do repositório), a validade do JSON, um reload do servidor em Customize ou um restart do Cursor, e então os MCP Logs no painel Output (Cmd+Shift+U, selecione MCP Logs). Se o servidor conecta mas as requisições falham com 401, a chave está faltando no header ou não é uma chave de API de conta com escopo.
O servidor responde sem chave quando o agente só lê a especificação da API. Para executar requisições reais, crie um Scope na sua aplicação Development, associe as contas de teste e gere uma chave de API de conta com escopo para esse Scope. Nunca dê a um cliente MCP uma chave Service ou uma chave de conta global.
Sim. O link de instalação desta página codifica a configuração do servidor; ele abre o Cursor com a entrada unipile já preenchida, e você troca o placeholder pela sua chave com escopo. O gerador opcional acima monta o mesmo link já com sua chave, inteiramente no seu navegador.
Sim. O CLI usa a mesma configuração do editor, projeto primeiro, depois global.
agent mcp list mostra os servidores configurados e o status de cada um, e /mcp list faz o mesmo dentro de uma sessão interativa. O agente então usa o servidor da Unipile quando uma solicitação exige.