Guias de integração
Guia da API do LinkedIn
Guia da API de e-mail
Guia da API do WhatsApp
Fale com vendas
Codex · MCP Server
Codex MCP Server: mensageria e e-mail no seu produto
Três linhas de config.toml conectam o Servidor MCP da Unipile. O Codex então cria recursos de LinkedIn, WhatsApp e e-mail no seu produto, pela CLI, pela extensão de IDE ou pelo app desktop. Nada para instalar ou rodar localmente.
Teste grátis de 7 dias, sem cartão de crédito.
Codex · crm-app
Unipile MCP conectado
Adicione a busca de pessoas do LinkedIn ao meu CRM.
Ler endpointPOST /v2/{account_id}/linkedin/searchschema carregado
Adicionei a rota de busca e a lista de resultados. Cada linha guarda o ID do provedor para o perfil.
Descreva o próximo recurso…
Caso de uso
Adicione LinkedIn, WhatsApp e e-mail ao seu produto pelo Codex
Adicione LinkedIn, WhatsApp, e-mail ou calendário ao seu produto. Pelo servidor MCP da Unipile, o Codex 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 CodexUnipile MCP conectado
Selecione os canais que quer conectar
developer.unipile.com/mcpConectar todos os canais10 canais
↑↓navegar espaçoselecionar ↵conectaruma URL, um header
config.toml, CLI e IDE
Adicione o servidor MCP da Unipile ao Codex
O servidor é remoto: uma URL via streamable HTTP e um header, nada para rodar localmente. Uma entrada no config.toml atende o Codex CLI, a extensão de IDE e o app desktop do ChatGPT.
Antes de começar: Codex CLI ou a extensão de IDE, 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.
codex mcp add e depois o headerregistra a URL em ~/.codex/config.toml
Configuração global~/.codex/config.toml
Configuração por projeto.codex/config.toml (projeto confiável)
Chave vinda de uma variável de ambienteenv_http_headers
?
Por que duas etapas no CLI?O codex mcp add não tem flag para header personalizado, então o header X-API-KEY vai no config.toml, à mão ou com env_http_headers.
# 1. Registre o servidor MCP hospedado da Unipile (config global)
codex mcp add unipile --url "https://developer.unipile.com/mcp?branch=v2.0"
# Added global MCP server 'unipile'.
# 2. Adicione o header X-API-KEY à entrada em ~/.codex/config.toml
[mcp_servers.unipile]
url = "https://developer.unipile.com/mcp?branch=v2.0"
http_headers = { "X-API-KEY" = "your-scoped-api-key" }
# 3. Verifique
codex mcp get unipile
[mcp_servers.unipile]
url = "https://developer.unipile.com/mcp?branch=v2.0"
http_headers = { "X-API-KEY" = "your-scoped-api-key" }
[mcp_servers.unipile]
url = "https://developer.unipile.com/mcp?branch=v2.0"
http_headers = { "X-API-KEY" = "your-scoped-api-key" }
# Lido apenas dentro de um projeto confiável. Mantenha a chave fora do git: prefira env_http_headers.
[mcp_servers.unipile]
url = "https://developer.unipile.com/mcp?branch=v2.0"
env_http_headers = { "X-API-KEY" = "UNIPILE_API_KEY" }
# export UNIPILE_API_KEY=your-scoped-api-key antes de iniciar o codex
Salve o arquivo e reinicie o Codex. Verificado no codex-cli 0.154.0.
Mantenha sua chave de API fora do config.toml. Em um arquivo compartilhado, use
env_http_headers para que cada desenvolvedor exporte o próprio UNIPILE_API_KEY, ou http_headers_helper para lê-la de um cofre. Mantenha default_tools_approval_mode em prompt enquanto desenvolve, se quiser confirmar cada escrita.Verifique a conexão
- 1No CLI,
codex mcp listmostra unipile como enabled, ecodex mcp get unipileos headers dele. - 2Dentro de uma sessão,
/mcplista o servidor; Auth Unsupported é esperado, já que ele usa um header, não OAuth. - 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 Codex, os endpoints que o agente executa em
https://api.unipile.com com seu X-API-KEY, e o que chega ao seu projeto.Adicione busca de pessoas do LinkedIn ao meu CRM e depois deixe o usuário abrir o perfil selecionado e iniciar uma conversa a partir dele.
Buscar endpoints"linkedin search people profile"3 resultados
Executar requisiçãoPOST /v2/{account_id}/linkedin/search10 resultados
Adicionei
GET /api/linkedin/search (palavras-chave, cursor de paginação) e GET /api/linkedin/profiles/:identifier. A lista de resultados guarda o ID de provedor devolvido pela busca, a rota de perfil o reaproveita, e o botão "Mensagem" o repassa para a criação do chat. Rodei os dois na aplicação Development.Um identificador do resultado da busca até a conversa
A parte difícil é manter o mesmo identificador da linha de busca até o perfil e depois até a mensagem. O Codex lê os três contratos e vê qual campo o carrega, então nada é adivinhado.
Endpoints usados pelo agente
Criar uma integração LinkedIn
POST/v2/{account_id}/linkedin/searchGET/v2/{account_id}/users/{identifier}POST/v2/{account_id}/chats
Gere um cliente tipado em Node.js e em Python para as rotas de chats e de e-mails da Unipile que usamos, a partir dos schemas da API, com retentativas em 429.
Ler endpointGET /v2/{account_id}/emailsschema carregado
Executar requisiçãoGET /v2/{account_id}/chats200 OK
Escrevi
unipile-client.ts e unipile_client.py a partir dos schemas de requisição e de resposta: métodos tipados de listagem e de envio para chats e e-mails, helper de paginação por cursor e backoff exponencial em 429 com o header Retry-After. Os dois clientes executaram as chamadas de listagem na aplicação Development.Clientes tipados a partir dos schemas reais, não de memória
O Codex lê o corpo da requisição e o schema de resposta de cada rota, gera os tipos e executa uma chamada por método na sua aplicação Development. Os SDKs oficiais de Node.js e Python continuam sendo a referência.
Endpoints usados pelo agente
Ver os SDKs oficiais
GET/v2/{account_id}/chatsPOST/v2/{account_id}/chats/{chat_id}/messages/sendGET/v2/{account_id}/emailsPOST/v2/{account_id}/emails/send
Dê suporte a várias contas conectadas por usuário do meu SaaS: eles podem vincular várias contas de LinkedIn e de e-mail e escolher por qual enviar.
Ler endpointGET /v2/accountsschema carregado
Executar requisiçãoGET /v2/accounts3 contas
Adicionei uma tabela
accounts indexada por usuário e account_id, um seletor no compositor, e POST /api/messages que envia pela conta selecionada. Os estados de reconexão vindos da rota de contas aparecem como badge. Verificado com três contas na aplicação Development.Um usuário, várias contas, um Scope por workspace
Cada conta que seus usuários conectam pelo Hosted Auth ganha o próprio
account_id. O agente associa seus usuários a esses IDs, mostra os estados de reconexão e de checkpoint, e direciona cada envio para a conta que o usuário escolheu.Endpoints usados pelo agente
Implementar o Hosted Auth com um agente
GET/v2/accountsGET/v2/accounts/{account_id}POST/v2/auth/linkPOST/v2/{account_id}/chats
Uma aplicação Development primeiro
Dê ao Codex 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
O que aparece quando uma entrada MCP do Codex não está certa, e a correção de cada caso.
O servidor não aparece depois de editar o config.toml
Reinicie o Codex, depois confira CODEX_HOME e execute codex mcp list no shell de onde você inicia o Codex.
A configuração de projeto é ignorada
Marque o projeto como confiável com trust_level = "trusted" em [projects."/path/to/repo"], ou mova a entrada para ~/.codex/config.toml.
TOML inválido
Nomeie a tabela [mcp_servers.unipile] exatamente assim e faça de http_headers uma tabela, com "X-API-KEY" entre aspas.
401 Unauthorized nas requisições
Exporte a variável indicada em env_http_headers no shell que iniciou o Codex, e use uma chave de API de conta com escopo.
As configurações dizem que o servidor está indisponível
Nada a mudar: essa verificação procura resources, e o servidor da Unipile expõe ações, como /mcp confirma.
Timed out
Confira a URL (?branch=v2.0 incluído), a rede e qualquer proxy antes de aumentar startup_timeout_sec.
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 Codex
As perguntas que as pessoas realmente digitam: config.toml em vez de mcp.json, onde ele fica, codex mcp add, como manter a chave fora do arquivo, as três superfícies, o que checar quando nada aparece, timeouts e chaves.
Não. O Codex guarda a configuração MCP em
~/.codex/config.toml, em TOML, uma tabela por servidor chamada [mcp_servers.<name>]. Não existe mcp.json no Codex, e o arquivo não é criado na instalação: você o cria, ou o codex mcp add o cria para você. Um projeto confiável também pode carregar um .codex/config.toml na própria raiz.~/.codex/config.toml para a configuração de usuário, .codex/config.toml na raiz do repositório para a configuração de projeto. A variável de ambiente CODEX_HOME muda todo o diretório de configuração: quando um servidor aparece em um terminal e não em outro, confira isso primeiro. O Codex CLI, a extensão da IDE e o app de desktop leem o mesmo arquivo.Em parte. O
codex mcp add unipile --url "https://developer.unipile.com/mcp?branch=v2.0" escreve a tabela de um servidor streamable HTTP, e o --bearer-token-env-var cobre servidores que aceitam um token Bearer. O servidor da Unipile autentica com um header X-API-KEY que o comando não consegue definir, então você acrescenta http_headers ou env_http_headers à entrada criada por ele. Verificado no codex-cli 0.154.0.Use
env_http_headers = { "X-API-KEY" = "UNIPILE_API_KEY" }: ele mapeia o nome do header para o nome de uma variável de ambiente em vez de um valor, então o arquivo pode ser versionado sem segredo e cada dev exporta a própria chave de API de conta com escopo. O http_headers serve para valores estáticos, e o http_headers_helper deixa um comando local produzir os headers como JSON.Sim. As três superfícies de um mesmo host Codex leem a mesma configuração, então um servidor adicionado uma vez fica disponível em todas. No app de desktop e na extensão você também pode adicioná-lo em Settings, MCP servers, Add server, escolhendo Streamable HTTP. Reinicie o cliente depois de salvar o arquivo.
Quatro causas, nesta ordem: o cliente não foi reiniciado; o arquivo está sob um
CODEX_HOME diferente do shell atual; a tabela está em um .codex/config.toml de projeto e o projeto não está marcado como trust_level = "trusted", caso em que o Codex ignora a camada de projeto inteira; ou o TOML é inválido. Execute codex mcp list, e depois /mcp dentro de uma sessão.startup_timeout_sec sobrescreve o timeout padrão de 10 segundos na inicialização e tool_timeout_sec o timeout padrão de 60 segundos por ferramenta, ambos sob a tabela do servidor. O servidor da Unipile é remoto, em HTTP, sem processo local para iniciar, então um timeout de inicialização quase sempre aponta para a URL, a rede ou um proxy corporativo, não para o servidor.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.