Guias de integração
Guia da API do LinkedIn
Guia da API de e-mail
Guia da API do WhatsApp
Fale com vendas
Gemini CLI · MCP Server
Gemini CLI MCP Server: mensageria, e-mail e calendário
Um único comando gemini mcp add conecta o Servidor MCP da Unipile. Seu agente então cria recursos de LinkedIn, WhatsApp, e-mail e calendário 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.
Gemini CLI · booking-app
Unipile MCP conectado
Adicione agendamento por calendário ao meu app de reservas.
Ler endpointGET /v2/{account_id}/calendarsschema carregado
Adicionei a rota de disponibilidade e a rota de reserva. Os eventos caem no calendário que o usuário conectou.
Descreva o próximo recurso…
Caso de uso
Adicione LinkedIn, WhatsApp e e-mail ao seu produto pelo Gemini CLI
Adicione LinkedIn, WhatsApp, e-mail ou calendário ao seu produto. Pelo servidor MCP da Unipile, o Gemini CLI 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 Gemini CLIUnipile MCP conectado
Selecione os canais que quer conectar
developer.unipile.com/mcpConectar todos os canais10 canais
↑↓navegar espaçoselecionar ↵conectaruma URL, um header
settings.json, de usuário ou de projeto
Adicione o servidor MCP da Unipile ao Gemini CLI
O servidor é remoto: uma URL via streamable HTTP e um header, nada para rodar localmente. Um comando o grava no settings.json, de usuário ou de projeto, e o Gemini CLI se conecta ao iniciar.
Antes de começar: Gemini CLI com login feito, em uma pasta confiável, 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.
gemini mcp add, uma linhaescreve o settings.json para você
Settings de usuário~/.gemini/settings.json
Settings de projeto.gemini/settings.json (scope padrão)
Chave vinda de uma variável de ambiente$UNIPILE_API_KEY em headers
?
De usuário ou de projeto?O comando usa por padrão o scope de projeto (.gemini/settings.json). Passe --scope user para valer em todos os projetos da máquina.
# Registre o servidor MCP hospedado da Unipile para todos os projetos (scope user)
gemini mcp add --transport http --scope user \
--header "X-API-KEY: your-scoped-api-key" \
unipile "https://developer.unipile.com/mcp?branch=v2.0"
# MCP server "unipile" added to user settings. (http)
# Verifique, ou digite /mcp dentro de uma sessão
gemini mcp list
# ✓ unipile: https://developer.unipile.com/mcp?branch=v2.0 (http) - Connected
{
"mcpServers": {
"unipile": {
"url": "https://developer.unipile.com/mcp?branch=v2.0",
"type": "http",
"headers": { "X-API-KEY": "your-scoped-api-key" }
}
}
}
{
"mcpServers": {
"unipile": {
"url": "https://developer.unipile.com/mcp?branch=v2.0",
"type": "http",
"headers": { "X-API-KEY": "$UNIPILE_API_KEY" }
}
}
}
// Versionado com o repositório: mantenha a chave no ambiente, não no arquivo.
{
"mcpServers": {
"unipile": {
"url": "https://developer.unipile.com/mcp?branch=v2.0",
"type": "http",
"headers": { "X-API-KEY": "${{UNIPILE_API_KEY}}" }
}
}
}
// export UNIPILE_API_KEY=your-scoped-api-key antes de iniciar o gemini
Salve o arquivo e inicie o gemini em uma pasta confiável. Verificado no gemini-cli 0.60.0.
httpUrl ou url. Escreva
httpUrl, ou url com "type": "http": um url sozinho é lido como SSE e aparece como Disconnected. Mantenha a chave em $UNIPILE_API_KEY e deixe a opção trust do servidor sem definir, para que o Gemini CLI continue confirmando cada ação.Verifique a conexão
- 1No terminal,
gemini mcp listmostra unipile como Connected; Disabled significa que a pasta não é confiável. - 2Dentro de uma sessão,
/mcplista cada servidor com o estado dele, e/mcp descdescreve cada açã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.
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 Gemini CLI, os endpoints que o agente executa em
https://api.unipile.com com seu X-API-KEY, e o que chega ao seu projeto.Adicione agendamento de calendário ao meu app de reservas: leia a disponibilidade de cada usuário ao longo de uma semana e crie a reunião no calendário que ele conectou, Google ou Outlook.
Ler endpointGET /v2/{account_id}/calendars/{calendar_id}/eventsschema carregado
Executar requisiçãoPOST /v2/{account_id}/calendars/{calendar_id}/events201 Created
Adicionei
GET /api/availability (eventos na janela pedida, horários ocupados calculados no servidor) e POST /api/bookings, que cria o evento com os participantes no calendário do usuário e guarda o ID de evento devolvido. Os fusos horários vêm do calendário. Criei um evento de teste na aplicação Development.Disponibilidade e criação de evento no calendário que seu usuário conectou
Google Calendar e Outlook Calendar compartilham as mesmas rotas de calendário. O Gemini CLI lê os schemas de calendário, evento e participante, escreve a lógica de disponibilidade e a rota de agendamento, e cria um evento em um calendário de teste.
Endpoints usados pelo agente
Ver todos os canais no servidor MCP da Unipile
GET/v2/{account_id}/calendarsGET/v2/{account_id}/calendars/{calendar_id}/eventsPOST/v2/{account_id}/calendars/{calendar_id}/events
Nossa inbox já sincroniza LinkedIn e WhatsApp com a Unipile. Adicione Instagram e Telegram com o mesmo modelo de thread e o mesmo endpoint de resposta.
Buscar endpoints"chats messages attendees"3 resultados
Executar requisiçãoGET /v2/{account_id}/chats200 OK
Nenhum modelo novo: os chats de Instagram e de Telegram vêm pelas mesmas rotas de chat e de mensagem, então o job de sincronização agora percorre todas as contas conectadas, seja qual for o provedor, e o endpoint de resposta envia pela própria conta do chat. Adicionei os dois badges de provedor e rodei a sincronização na aplicação Development com uma conta de teste do Instagram e uma do Telegram.
Mesmas rotas, dois canais a mais, nenhum modelo novo
Todo provedor de mensageria usa as mesmas rotas de chat, então ampliar uma inbox é vincular contas pelo Hosted Auth. O agente confere os campos específicos de cada provedor e mantém seu modelo de thread inalterado.
Endpoints usados pelo agente
Criar uma inbox unificada com um agente
GET/v2/accountsGET/v2/{account_id}/chatsGET/v2/{account_id}/chats/{chat_id}/messagesPOST/v2/{account_id}/chats/{chat_id}/messages/send
Revise minha integração atual com a Unipile em busca de IDs incorretos, retentativas inseguras e chamadas que deveriam ser webhooks, e proponha as correções.
Ler endpointPOST /v2/{account_id}/chats/{chat_id}/messages/sendschema carregado
Ler endpointPOST /v2/webhooks/endpoints/schema carregado
Encontrei três problemas: a chamada de envio usava a primeira conta do workspace em vez da conta do chat; o wrapper de retentativa reenviava mensagens em caso de timeout; a inbox consultava a rota de chats a cada 30 segundos. Patches propostos: ID de conta obtido do chat, retentativas limitadas às leituras, um endpoint de webhook para eventos de mensagem. Aplicado e verificado na aplicação Development.
Uma auditoria contra o contrato real, não contra a memória
O agente compara seu código com os schemas reais de requisição e de resposta: campos de conta, chamadas idempotentes, loops de polling que os webhooks substituem. A revisão chega como um diff, testado na sua aplicação Development.
Endpoints usados pelo agente
Configurar webhooks com um agente
GET/v2/accounts/{account_id}POST/v2/{account_id}/chats/{chat_id}/messages/sendPOST/v2/webhooks/endpoints/GET/v2/webhooks/conversations/
Uma aplicação Development primeiro
Dê ao Gemini CLI 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 gemini mcp list e /mcp mostram quando uma entrada não está certa, e a correção de cada caso.
No MCP servers configured.
Coloque mcpServers no nível superior de ~/.gemini/settings.json ou .gemini/settings.json, sem vírgula sobrando no final.
Disconnected
Use httpUrl, ou url com "type": "http", já que um url sozinho é lido como SSE.
Disabled, pasta não confiável
Aceite o pedido de confiança na primeira execução, ou execute gemini trust no projeto.
Adicionado no lugar errado
Adicione --scope user ao gemini mcp add, que por padrão grava no arquivo do projeto .gemini/settings.json.
401 Unauthorized nas requisições
Connected não verifica a chave: exporte a variável indicada em headers e use uma chave de API de conta com escopo.
Timed out
Confira a rede, qualquer proxy e a URL antes de definir timeout na entrada.
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 Gemini CLI
As perguntas que as pessoas realmente digitam: httpUrl ou url, onde fica o settings.json, um comando em vez de JSON, como manter a chave fora do arquivo, Disconnected, No MCP servers configured, a extensão do VS Code e as chaves.
A documentação define
httpUrl como o endpoint streamable HTTP e url como um endpoint SSE. O comando gemini mcp add --transport http grava url junto com "type": "http", e as duas formas conectam nas versões atuais. Se você escrever o arquivo na mão, use httpUrl: um url sozinho, sem type, é lido como SSE, a causa mais citada de um servidor Disconnected.As settings de usuário em
~/.gemini/settings.json, as de projeto em .gemini/settings.json na raiz do seu projeto, ambas sob a chave mcpServers do JSON, e as de projeto têm prioridade sobre as de usuário. Atenção ao padrão do comando: gemini mcp add grava no scope de projeto, a menos que você passe --scope user.Sim, e é o caminho recomendado:
gemini mcp add --transport http --scope user --header "X-API-KEY: your-scoped-api-key" unipile "https://developer.unipile.com/mcp?branch=v2.0". A flag --header é repetível e pode ficar em qualquer posição do comando. Verificado no gemini-cli 0.60.0.Escreva o valor do header como
"$UNIPILE_API_KEY" ou "${UNIPILE_API_KEY}". O Gemini CLI expande variáveis de ambiente no settings.json, inclusive em headers, então o arquivo de projeto pode ser versionado sem segredo e cada dev exporta a própria chave de API de conta com escopo antes de iniciar o gemini.Nesta ordem: a chave de transporte (
httpUrl para streamable HTTP, ou url com "type": "http"), um settings.json de projeto que sobrepõe o seu ou o contrário, a confiança da pasta (uma pasta não confiável desativa todos os servidores) e, por fim, um status exibido como Disconnected enquanto as ações funcionam, que vem de um ping opcional da especificação. Execute gemini mcp list, e depois /mcp dentro de uma sessão.O Gemini CLI não encontrou nenhuma entrada
mcpServers na configuração que lê a partir da pasta atual. Confira se o arquivo está em ~/.gemini/ ou em .gemini/ na raiz do projeto, se mcpServers está no nível superior do JSON e se o JSON é válido: uma vírgula sobrando já basta para o arquivo ser ignorado.Esta página cobre o Gemini CLI no terminal, e a configuração descrita aqui é o settings.json lido pelo CLI. A extensão tem as próprias configurações de MCP no VS Code; confira a documentação dela antes de supor que o arquivo é compartilhado.
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.