BR
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
Sarah
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.
3 arquivos alterados · testado na aplicação Development
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 conectardeveloper.unipile.com/mcp
Conectar todos os canais10 canais
LinkedInLinkedIn/v2/{account_id}/chats
WhatsAppWhatsApp/v2/{account_id}/chats
InstagramInstagram/v2/{account_id}/chats
TelegramTelegram/v2/{account_id}/chats
GmailGmail/v2/{account_id}/emails
OutlookOutlook/v2/{account_id}/emails
IMAPIMAP/v2/{account_id}/emails
Google CalendarGoogle Calendar/v2/{account_id}/calendars
Outlook CalendarOutlook Calendar/v2/{account_id}/calendars
↑↓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.
1
codex mcp add e depois o headerregistra a URL em ~/.codex/config.toml
G
Configuração global~/.codex/config.toml
P
Configuração por projeto.codex/config.toml (projeto confiável)
E
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.
terminal
# 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

  1. 1No CLI, codex mcp list mostra unipile como enabled, e codex mcp get unipile os headers dele.
  2. 2Dentro de uma sessão, /mcp lista o servidor; Auth Unsupported é esperado, já que ele usa um header, não OAuth.
  3. 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 um e 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.
Codex · crm-appAplicação Development
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.4 arquivos alterados · testado 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
POST/v2/{account_id}/linkedin/searchGET/v2/{account_id}/users/{identifier}POST/v2/{account_id}/chats
Criar uma integração LinkedIn
Codex · messaging-sdkAplicação Development
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.2 clientes gerados · schemas lidos pelo servidor

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
GET/v2/{account_id}/chatsPOST/v2/{account_id}/chats/{chat_id}/messages/sendGET/v2/{account_id}/emailsPOST/v2/{account_id}/emails/send
Ver os SDKs oficiais
Codex · saas-backendAplicação Development
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.5 arquivos alterados · 3 contas, um compositor

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
GET/v2/accountsGET/v2/accounts/{account_id}POST/v2/auth/linkPOST/v2/{account_id}/chats
Implementar o Hosted Auth com um agente
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
SOC 2 Tipo II
Certificado
Controles de segurança auditados de forma independente, garantindo a proteção dos dados e a integridade operacional.
GDPR
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.