BR
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
Sarah
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.
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 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 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
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.
1
gemini mcp add, uma linhaescreve o settings.json para você
U
Settings de usuário~/.gemini/settings.json
P
Settings de projeto.gemini/settings.json (scope padrão)
E
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.
terminal
# 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

  1. 1No terminal, gemini mcp list mostra unipile como Connected; Disabled significa que a pasta não é confiável.
  2. 2Dentro de uma sessão, /mcp lista cada servidor com o estado dele, e /mcp desc descreve cada ação.
  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 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.
Gemini CLI · booking-appAplicação Development
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.4 arquivos alterados · testado 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
GET/v2/{account_id}/calendarsGET/v2/{account_id}/calendars/{calendar_id}/eventsPOST/v2/{account_id}/calendars/{calendar_id}/events
Ver todos os canais no servidor MCP da Unipile
Gemini CLI · support-inboxAplicação Development
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.3 arquivos alterados · 4 canais em uma só lista

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
GET/v2/accountsGET/v2/{account_id}/chatsGET/v2/{account_id}/chats/{chat_id}/messagesPOST/v2/{account_id}/chats/{chat_id}/messages/send
Criar uma inbox unificada com um agente
Gemini CLI · crm-appAplicação Development
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.3 achados · 3 patches · 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
GET/v2/accounts/{account_id}POST/v2/{account_id}/chats/{chat_id}/messages/sendPOST/v2/webhooks/endpoints/GET/v2/webhooks/conversations/
Configurar webhooks com um agente
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
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 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.