Guias de integração
Guia da API do LinkedIn
Guia da API de e-mail
Guia da API do WhatsApp
Fale com vendas
Claude Code · MCP Server
Claude Code MCP Server: mensageria e e-mail no seu app
Um único comando claude mcp add conecta o Servidor MCP da Unipile. O Claude Code 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.
Claude Code · 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 Claude Code
Adicione LinkedIn, WhatsApp, e-mail ou calendário ao seu produto. Pelo servidor MCP da Unipile, o Claude Code 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 Claude CodeUnipile MCP conectado
Selecione os canais que quer conectar
developer.unipile.com/mcpConectar todos os canais10 canais
↑↓navegar espaçoselecionar ↵conectaruma URL, um header
claude mcp add, três scopes
Adicione o servidor MCP da Unipile ao Claude Code
O servidor é remoto: uma URL via streamable HTTP e um header, nada para rodar localmente. Um comando o registra; o scope escolhido define onde ele carrega.
Antes de começar: Claude Code instalado e com login feito, 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.
Scope user--scope user · todos os projetos, privado para você
Scope project.mcp.json na raiz do repositório, compartilhado
Scope local (padrão)só este projeto, privado, em ~/.claude.json
?
Qual scope escolher?User para todos os projetos, project para compartilhar o .mcp.json com o time, local para um teste pontual.
# Scope user: todos os projetos desta máquina, privado para você
claude mcp add --transport http --scope user \
unipile "https://developer.unipile.com/mcp?branch=v2.0" \
--header "X-API-KEY: your-scoped-api-key"
# O Claude Code imprime "Added …", depois: claude mcp list
// Scope project: versionado na raiz do repositório, compartilhado com o time
{
"mcpServers": {
"unipile": {
"type": "http",
"url": "https://developer.unipile.com/mcp?branch=v2.0",
"headers": {
"X-API-KEY": "${UNIPILE_API_KEY}"
}
}
}
}
// "type": "http" é obrigatório; cada dev exporta UNIPILE_API_KEY
# Scope local (padrão): só este projeto, privado, salvo em ~/.claude.json
claude mcp add --transport http \
unipile "https://developer.unipile.com/mcp?branch=v2.0" \
--header "X-API-KEY: your-scoped-api-key"
Verificado no Claude Code 2.1. Coloque a URL entre aspas (o zsh trata o ? como padrão) e deixe --header por último.
Verifique a conexão
- 1No terminal,
claude mcp listmostra ✔ Connected, eclaude mcp get unipileos detalhes. - 2Dentro de uma sessão,
/mcpmostra o status e aprova um .mcp.json com scope project na primeira vez. - 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.
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 Claude Code, 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 WhatsApp ao nosso console de suporte: sincronize as conversas de cada atendente e deixe que respondam a partir do ticket.
Buscar endpoints"chats messages send"3 resultados
Executar requisiçãoGET /v2/{account_id}/chats9 chats
Criei
whatsapp/chat-sync.ts (chats e mensagens salvos no ticket, paginação por cursor) e POST /tickets/:id/reply que chama a rota de envio pela própria conta do chat. Rodei a sincronização na aplicação Development: 9 chats, 41 mensagens.Uma inbox do WhatsApp dentro do seu produto, a partir de um prompt
O Claude Code 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. LinkedIn, Instagram, Facebook e Telegram usam as mesmas rotas de chat.
Endpoints usados pelo agente
API do WhatsApp
GET/v2/{account_id}/chatsGET/v2/{account_id}/chats/{chat_id}/messagesPOST/v2/{account_id}/chats/{chat_id}/messages/send
Permita que os usuários enviem e-mails da página do contato pela própria caixa Gmail ou Outlook, e encadeie as respostas no contato.
Ler endpointPOST /v2/{account_id}/emails/sendschema carregado
Executar requisiçãoGET /v2/{account_id}/emails200 OK
Adicionei
POST /contacts/:id/email que chama a rota de envio pela conta de e-mail do usuário, a opção de responder na thread usando o ID da thread, e a sincronização de entrada que anexa as respostas ao contato. Enviei um e-mail de teste da caixa da aplicação Development e vi a resposta encadeada.E-mail pela própria caixa do usuário, encadeado no seu CRM
Gmail, Outlook e IMAP compartilham um único schema de e-mail. O agente liga a ação de envio à caixa de e-mail que o usuário conectou e guarda o ID da thread, para que as respostas cheguem ao contato certo.
Endpoints usados pelo agente
API de e-mail
POST/v2/{account_id}/emails/sendGET/v2/{account_id}/emailsGET/v2/{account_id}/threads/{thread_id}
Cada workspace do meu SaaS tem vários usuários com contas próprias de LinkedIn e de e-mail. Isole tudo: um Scope e uma chave com escopo por workspace.
Buscar endpoints"scopes api-keys"4 resultados
Executar requisiçãoPOST /v2/scopes/201 · scope
Na criação de um workspace o backend agora cria um Scope, uma chave de API de conta com escopo guardada criptografada no workspace, e toda conta que um membro conecta é associada a esse Scope. Todas as chamadas de conta usam a chave do workspace. Testado com dois workspaces na aplicação Development.
Muitos usuários, muitas contas, uma fronteira por tenant
Uma chave com escopo só enxerga as contas atribuídas ao seu Scope. O agente transforma essa fronteira no seu modelo de tenant, e a lógica multicontas fica na API, não no seu código.
Endpoints usados pelo agente
Contas, Scopes e chaves
POST/v2/scopes/POST/v2/api-keys/GET/v2/accounts/
Uma aplicação Development primeiro
Dê ao Claude Code 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
Os status que claude mcp list e /mcp exibem quando uma entrada não está certa, e a correção de cada um.
✘ Failed to connect
Use exatamente https://developer.unipile.com/mcp?branch=v2.0 com --transport httpe depois confira com claude mcp get unipile.
⏸ Pending approval
Execute claude na pasta, aceite a caixa de diálogo de confiança do workspace e depois aprove o servidor em /mcp.
401 nas requisições
Envie uma chave de API de conta com escopo da sua aplicação Development, com o nome de header exato X-API-KEY.
Aviso de variável ausente
Exporte UNIPILE_API_KEY no shell que inicia o Claude Code, ou defina um padrão com ${UNIPILE_API_KEY:-}.
Espaços invisíveis em headers.X-API-KEY
Adicione o servidor de novo com a chave sem espaços: o Claude Code usa os valores exatamente como estão escritos.
Mesmo nome em mais de um scope
Mantenha uma única definição, por exemplo com claude mcp remove unipile --scope user: local prevalece sobre project, depois user.
MCP endpoint not found at <origin>
Use a URL completa https://developer.unipile.com/mcp?branch=v2.0, confira com curl -I, e depois execute claude mcp get unipile.
/mcp mostra No MCP servers configured
Use ~/.claude.json ou .mcp.json na raiz do projeto, nunca ~/.claude/mcp.json, e depois reinicie a sessão.
O shell rejeita a URL, ou o branch some
Sempre coloque a URL entre aspas em claude mcp add, senão o zsh responde "no matches found" e o bash pode descartar o parâmetro.
Início lento ou timeout
Aumente o limite da sessão com MCP_TIMEOUT=60000 claude.
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 Claude Code
As perguntas que as pessoas realmente digitam: scopes, onde fica a configuração, chaves fora do repositório, headers personalizados, Failed to connect, aspas na URL, mudanças no .mcp.json e chaves de API.
Local é o padrão: guardado em
~/.claude.json sob o projeto atual, privado e limitado a esse projeto. Project grava .mcp.json na raiz do repositório e é compartilhado pelo controle de versão. User grava ~/.claude.json sob a chave raiz mcpServers e vale para todos os seus projetos. A precedência é local, depois project, depois user. Para a Unipile: --scope user para sua chave pessoal de desenvolvimento, --scope project quando o time inteiro trabalha na mesma integração.Em
~/.claude.json (no Windows %USERPROFILE%\.claude.json) para os scopes local e user, e em .mcp.json na raiz do projeto para o scope project. O Claude Code não lê ~/.claude/.mcp.json, ~/.claude/config/mcp.json, ~/.claude/mcp.json ou %APPDATA%\Claude\mcp.json. claude mcp get unipile informa em qual scope uma entrada está.O Claude Code expande
${VAR} e ${VAR:-default} em command, args, env, url e headers. Escreva "X-API-KEY": "${UNIPILE_API_KEY}" em .mcp.json, versione o arquivo, e cada dev fornece a própria chave com escopo pelo ambiente. Se a variável não estiver definida e não houver padrão, a configuração ainda carrega e claude mcp list mostra um aviso.Sim:
--header "X-API-KEY: your-scoped-api-key", repetível para vários headers, na forma curta -H. Coloque depois da URL, porque a flag aceita vários valores. O servidor da Unipile é um servidor HTTP remoto: nada para instalar localmente, sem npx, sem Node para gerenciar.Execute
claude mcp get unipile para ver o detalhe (status HTTP e texto do erro), confira os avisos de espaço no começo ou no fim que o claude mcp list imprime depois de uma chave colada, e confirme que a URL responde da sua máquina com curl -I. Um 404 imprime MCP endpoint not found at <origin>: o path está errado, a URL completa é https://developer.unipile.com/mcp?branch=v2.0, com o parâmetro branch incluído.A URL contém um
?, que o zsh lê como caractere de padrão. Sempre coloque a URL entre aspas em claude mcp add. Sem aspas, o zsh responde "no matches found" e o bash pode descartar o parâmetro branch da URL, o que conecta você à versão errada do servidor.O Claude Code lê
.mcp.json no início da sessão: saia e reabra. Uma entrada malformada é ignorada em silêncio, e claude mcp list imprime o aviso de parsing com o campo defeituoso. Se você recusou o servidor na pergunta de aprovação do projeto, execute claude mcp reset-project-choices.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 apenas as contas envolvidas 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.