Adako

O Adako conecta sua IA às suas contas do Google Ads, Meta Ads, Linkedin Ads e ChatGPT Ads. Veja como as campanhas estão performando, lance novas e corte o que desperdiça dinheiro.

GitHub

Experimente este MCPPatrocinado

Servidor MCP hospedado

npx add-mcp 'https://adako.ai/mcp'

Instala no Claude Code, Codex, Cursor e outros

Documentação

Adako: operações de anúncios para assistentes de IA

アダコ · adako.ai

Adako é um servidor MCP e API REST que conecta Claude, ChatGPT, Cursor e outros assistentes ao Google Ads, Meta Ads, ChatGPT Ads, TikTok Ads e LinkedIn Ads.

https://adako.ai/mcp

Pergunte "como foram minhas campanhas no mês passado?" e receba uma resposta da conta ativa, na moeda da própria conta. Pergunte "aumente esse orçamento para 40 por dia" e receba uma proposta que você aprova antes que qualquer coisa seja movida. Campanhas criadas ficam sempre pausadas.

Este repositório contém as partes públicas: as Agent Skills, a configuração por cliente, instaladores de arquivo único, um plugin para Claude Code e a entrada no MCP Registry. O servidor em si é hospedado.

O que ele pode fazer

233 ferramentas em cinco plataformas, além das próprias do Adako.

Plataforma	Ferramentas	O que cobrem
Google Ads	70	Search e Performance Max, palavras-chave e termos de pesquisa, orçamentos e estratégias de lance, ativos e extensões, ações de conversão, rótulos, agendamentos, geo, relatórios por hora e por dispositivo
Meta Ads	44	Campanhas, conjuntos de anúncios e anúncios, lançamentos de imagem, vídeo, carrossel e instalação de app, públicos e posicionamentos, pixels, formulários de lead, fadiga criativa
LinkedIn Ads	34	Grupos de campanha e campanhas, anúncios de imagem, vídeo, carrossel e texto, segmentação B2B, previsões de público, regras de conversão, métricas de engajamento
TikTok Ads	30	Campanhas, grupos de anúncios e anúncios de vídeo in-feed, Spark Ads, métricas de vídeo, identidades, pixels, fadiga criativa
ChatGPT Ads	23	Campanhas de chat card de ponta a ponta, limites de conta, pixels, veredictos de revisão
Adako	32	Conexões e uso, descoberta de ferramentas, propostas, diagnósticos, monitores, briefings e relatórios

Seu cliente não vê 233 entradas. Ele vê 16 ferramentas chamáveis por nome, além de 13 roteadores. Cada plataforma tem um roteador de leitura (google_ads, meta_ads, chatgpt_ads, tiktok_ads, linkedin_ads) e um roteador de escrita ao lado (google_ads_write, meta_ads_write, chatgpt_ads_write, tiktok_ads_write, linkedin_ads_write). Os monitores têm monitoring e monitoring_write, e diagnostics apenas lê. Uma leitura parece com google_ads(action="execute", tool_name="google_list_campaigns", arguments={...}), uma alteração com google_ads_write(action="execute", tool_name="google_pause_campaign", arguments={...}).

Consultas nunca alteram uma conta, então um assistente que pede permissão por ferramenta pode permitir leituras uma única vez. Toda alteração passa por uma ferramenta _write, que pergunta a cada vez e cria uma proposta. search_tools encontra a ferramenta certa a partir das suas próprias palavras e retorna a linha exata de chamada, e é gratuito. Veja adako.ai/docs/routers.

As leituras do LinkedIn Ads são abertas a todos: conecte o membro que administra a conta de anúncios e todas as ferramentas de relatório, estrutura e previsão funcionam. Uma alteração exige que essa conta de anúncios seja adicionada ao aplicativo do Adako no LinkedIn primeiro — envie o id de nove dígitos para support@adako.ai. As ferramentas do TikTok Ads estão na superfície, mas contas do TikTok não podem ser conectadas até que o TikTok aprove o aplicativo de desenvolvedor do Adako.

O modelo de segurança

O Adako foi construído para que um assistente possa ser útil sem ser perigoso.

Regra	O que significa
Leituras são executadas imediatamente	Desempenho, estrutura, termos de pesquisa, públicos. Nada para aprovar.
Toda escrita vira uma proposta	Você vê o objeto, os valores antes e depois, e o custo diário antes de qualquer coisa ser enviada.
A aprovação é sua	Confirme no chat, ou deixe propostas em uma caixa de entrada e aprove-as em adako.ai/approvals. Propostas expiram após 48 horas.
Objetos criados ficam pausados	Toda campanha, conjunto de anúncios e anúncio que o Adako cria começa pausado. Você ativa por conta própria.
Quase nada é excluído	Oito ferramentas removem algo e cada uma exige um sinalizador explícito de confirmação. Pausar nunca direciona para uma exclusão.
Executado uma única vez	Cada proposta aprovada carrega uma chave de idempotência. Aprovar duas vezes relata o primeiro resultado e não repete nada.
Leitura de retorno em toda escrita	A alteração é confirmada lendo o objeto de volta da plataforma, não confiando na resposta.
Tokens permanecem no servidor	Seus tokens de plataforma são mantidos criptografados pelo Adako e nunca são encaminhados ao cliente de IA.

Detalhes: adako.ai/docs/safety.

Instalação — cinco minutos

Duas formas de autenticar:

OAuth — o cliente abre um navegador, você entra no Adako uma vez. Preferido onde quer que funcione.
Chave de API — crie uma em adako.ai/keys, envie-a como Authorization: Bearer ak_live_your_key, onde ak_live_your_key é substituído pela chave inteira que você copiou, com o prefixo incluído e nada ao redor. Use para clientes que leem um arquivo de configuração estático.

Escolha seu cliente.

Claude.ai (conector personalizado)

Pro e Max: Configurações → Conectores → Adicionar conector personalizado. Cole a URL, clique em Adicionar, depois Conectar e entre.

Team e Enterprise: um proprietário adiciona primeiro em Configurações da organização → Conectores → Adicionar, passa o mouse sobre Personalizado, escolhe Web e cola a URL. Os membros então conectam a partir das suas próprias Configurações → Conectores.

https://adako.ai/mcp

O número de conectores personalizados que você pode adicionar depende do seu plano Claude.

Claude Desktop

As mesmas Configurações de Conectores do Claude.ai — adicione o conector personalizado com a URL acima e entre quando solicitado. O Desktop compartilha sua conta Claude, então um conector adicionado na web está disponível aqui também. Guia completo: clients/claude-desktop.md.

Claude Code

claude mcp add --transport http adako https://adako.ai/mcp

Depois execute /mcp dentro de uma sessão e escolha adako para entrar pelo navegador.

Adicione uma vez para cada projeto com --scope user:

claude mcp add --transport http adako https://adako.ai/mcp --scope user

Variante com chave de API, sem etapa de navegador:

claude mcp add --transport http adako https://adako.ai/mcp \
  --header "Authorization: Bearer ak_live_your_key"

Também existe um plugin que instala o servidor, as skills, um comando de configuração e um agente operador em uma única etapa:

/plugin marketplace add ruslan2027/adako-mcp
/plugin install adako@adako
/adako-setup

Veja clients/claude-code.md e plugin/.

ChatGPT (modo desenvolvedor)

Ative o Modo desenvolvedor em Configurações → Segurança e login, depois abra ChatGPT Plugins.
Clique em +. Digite Adako como nome da conexão e https://adako.ai/mcp como URL do servidor MCP. Adicione uma descrição curta, escolha a opção de conexão de endpoint público e clique em Criar.
Conclua a autorização se solicitado.
Inicie uma nova conversa, abra o menu de ferramentas e selecione Adako.

Guia completo: clients/chatgpt.md.

Cursor

Um comando, idempotente, e que não interfere nos seus outros servidores:

node install/cursor.mjs            # the home-folder .cursor/mcp.json
node install/cursor.mjs --project  # .cursor/mcp.json in this repository

Ou escreva o arquivo você mesmo:

{
  "mcpServers": {
    "adako": {
      "url": "https://adako.ai/mcp"
    }
  }
}

Arquivo completo: clients/cursor/mcp.json. Guia: clients/cursor.md.

Este repositório também é um plugin do Cursor, para o Cursor Marketplace: .cursor-plugin/plugin.json adiciona o servidor e as skills em skills/.

Codex CLI

codex mcp add adako --url https://adako.ai/mcp
codex mcp login adako

Ou execute o instalador, que reescreve uma tabela na configuração do Codex (C:\Users\<you>\.codex\config.toml no Windows ou /Users/<you>/.codex/config.toml no macOS) e deixa o restante do arquivo intacto:

node install/codex.mjs            # API key from $ADAKO_API_KEY
node install/codex.mjs --oauth    # sign in with codex mcp login instead

Arquivo completo: clients/codex/config.toml. Guia: clients/codex.md.

Windsurf

node install/windsurf.mjs

Ou adicione o bloco manualmente em C:\Users\<you>\.codeium\windsurf\mcp_config.json no Windows ou /Users/<you>/.codeium/windsurf/mcp_config.json no macOS:

{
  "mcpServers": {
    "adako": {
      "serverUrl": "https://adako.ai/mcp"
    }
  }
}

Arquivo completo: clients/windsurf/mcp_config.json. Guia: clients/windsurf.md.

Gemini (aplicativo personalizado)

Em um computador, abra gemini.google.com/apps, ou Configurações → Aplicativos conectados, depois role até Aplicativos personalizados na parte inferior, escolha Adicionar um aplicativo personalizado e cole a URL:

https://adako.ai/mcp

Clique em Avançar e entre. Deixe os campos de credenciais em Recursos avançados vazios: o Adako se registra sozinho. Em um chat, digite @ e escolha Adako.

Guia: clients/gemini.md. Aplicativos personalizados ainda estão em implementação gradual, com condições que o Google lista: uma conta Google pessoal, inglês, Estados Unidos, 18 anos ou mais.

Antigravity (app, IDE e a CLI agy)

Todos os três leem um único arquivo, então o Adako é adicionado uma vez. No app desktop: Configurações → Personalizações, depois Abrir Config MCP. Na IDE: o painel lateral do agente, … → Servidores MCP. Na CLI: /mcp, ou o próprio arquivo — C:\Users\<you>\.gemini\config\mcp_config.json no Windows ou /Users/<you>/.gemini/config/mcp_config.json no macOS (Linux: /home/<you>/.gemini/config/mcp_config.json). Use .agents/mcp_config.json para um único projeto. Depois de salvar, pressione atualizar ao lado de Servidores MCP instalados e clique em Adako para entrar.

{
  "mcpServers": {
    "adako": {
      "serverUrl": "https://adako.ai/mcp"
    }
  }
}

O Antigravity faz login pelo navegador na primeira chamada. Guia: clients/antigravity.md.

A CLI do Gemini parou de atender contas gratuitas e Pro em 18 de junho de 2026 e agora roda apenas com chaves de API pagas do Gemini e do Gemini Enterprise. Se você ainda a usa, a grafia mais antiga funciona: httpUrl em .gemini/settings.json na sua pasta pessoal, com os manifestos de extensão gemini-extension.json e clients/gemini-cli/gemini-extension.json. Separadamente, agy plugin import gemini leva uma configuração existente para o Antigravity.

VS Code (Copilot)

.vscode/mcp.json em um workspace, ou o seu mcp.json de usuário:

{
  "servers": {
    "adako": {
      "type": "http",
      "url": "https://adako.ai/mcp"
    }
  }
}

O VS Code cuida do fluxo OAuth. Arquivo completo com a variante de chave de API: clients/vscode/mcp.json. Guia: clients/vscode.md.

Perplexity

Adicione o Adako como conector personalizado: na web em perplexity.ai/computer/connectors, ou Configurações → Conectores no app desktop, depois a URL acima com OAuth. Conectores personalizados vêm com Pro, Max e Enterprise. Guia: clients/perplexity.md.

Adicione as skills

skills/ contém onze Agent Skills. adako é o procedimento operacional: o contrato de segurança, o contrato de chamada de ferramenta, o mapa de ferramentas e os fluxos de trabalho. As outras são focadas: uma por plataforma, uma por tarefa.

Skill	Para
`adako`	O procedimento operacional. Comece aqui.
`google-ads`, `meta-ads`, `tiktok-ads`, `linkedin-ads`, `chatgpt-ads`	Uma plataforma cada: ferramentas por função, regras, ordem de lançamento
`launch`	Criar uma campanha com segurança em qualquer plataforma
`performance-review`	Responder "como estamos indo" com números que se sustentam
`optimize`	O que mudar após a revisão, e em que ordem
`creative`	Limites de cópia e especificações de assets por plataforma, e o manual de fadiga
`monitoring`	Monitores, alertas, briefs e relatórios

Claude Code — instale o plugin, ou copie skills/ para a pasta .claude/skills/ no seu diretório pessoal (C:\Users\<you>\.claude\skills\ no Windows ou /Users/<you>/.claude/skills/ no macOS).
claude.ai — envie SKILL.md (o mesmo arquivo que skills/adako/SKILL.md) como uma skill nas configurações.
Qualquer outra coisa — cole o conteúdo no seu prompt de sistema ou nas instruções do projeto.

O servidor também envia instruções curtas na conexão, então as skills são opcionais. Elas tornam sessões longas visivelmente mais estáveis.

API REST e linha de comando

As mesmas ferramentas rodam via HTTP com uma chave de API.

curl -X POST https://adako.ai/api/v1/tools/google_get_campaign_performance/execute \
  -H "Authorization: Bearer ak_live_your_key" \
  -H "Idempotency-Key: $(uuidgen)" \
  -H "Content-Type: application/json" \
  -d '{"arguments": {"date_range": "last_30_days"}}'

GET /api/v1/tools lista todas as ferramentas chamáveis. GET /api/v1/openapi.json é o contrato legível por máquina, que n8n, Zapier e Make podem importar. Referência completa: adako.ai/docs/api.

A linha de comando adako encapsula os mesmos endpoints para scripts e agentes de codificação:

npx @adako/cli login
npx @adako/cli google list-campaigns --customer-id 1234567890
npx @adako/cli meta get-campaign-performance --date-range last_30_days --raw

O código-fonte está em cli/: ESM puro, sem dependências, Node 22 ou mais recente. O pacote publicado é @adako/cli no npm.

Conecte suas contas

Entre em adako.ai.
Abra Contas e conecte uma plataforma. Google Ads e LinkedIn Ads fazem login pela plataforma; Meta Ads exige um token de acesso de um usuário do sistema no seu próprio app Meta; ChatGPT Ads exige uma chave de API de anunciante. Você nunca entrega uma senha ou um token ao seu cliente de IA.
Ative as contas com as quais o Adako pode trabalhar e escolha a principal para cada plataforma.
De volta ao seu assistente, diga "comece aqui".

Primeiros prompts

Somente leitura, então nada pode ser movido:

"Comece aqui."
"A quais contas de anúncios estou conectado?"
"Como minhas campanhas do Google foram nos últimos 30 dias comparadas com os 30 anteriores?"
"Encontre termos de pesquisa que gastaram dinheiro e não converteram nada no mês passado."
"Quais conjuntos de anúncios do Meta estão gastando sem resultados esta semana?"
"Detalhe meu melhor conjunto de anúncios do Meta por posicionamento."
"Quais dos meus anúncios do TikTok estão mostrando fadiga criativa?"
"Qual foi o custo por lead do LinkedIn no mês passado, e quais títulos de cargo ele alcançou?"
"Execute essa verificação de gastos desperdiçados em todas as minhas contas ativas."

Depois, quando quiser uma mudança:

"Sugira dez palavras-chave negativas dessa lista e me diga o que cada uma bloqueia."
"Pause a campanha que gastou mais sem conversões."
"Aumente o orçamento diário da Busca da Marca para 40."
"Elabore uma campanha de Busca pausada para {produto} segmentando {cidade}, 25 por dia."
"Me alerte se o CPA ficar acima de 80 por dois dias seguidos, e me envie um brief toda segunda-feira."

Cada um desses termina com uma proposta que você aprova ou rejeita.

Preços

O plano gratuito inclui 1 conta de anúncios e 30 tarefas por mês. Pro ($49/mês) cobre 5 contas de anúncios e 600 tarefas por mês, Agency ($149/mês) 20 contas e 5.000 tarefas, e Enterprise é precificado por contrato. Uma conta usada em um período de cobrança mantém seu lugar até o período reiniciar. Uma tarefa é uma mudança cobrada em uma conta de anúncios; leituras e ferramentas de conexão, uso, proposta, descoberta, diagnóstico e resolução são gratuitas. Monitores, briefs agendados e relatórios gerados exigem Pro ou superior. Detalhes em adako.ai/pricing.

Documentação

adako.ai/docs — início rápido, uma página por cliente, uma página por plataforma, a superfície de ferramentas, fluxos de trabalho, monitores, a referência completa de ferramentas e a API REST.

Suporte

support@adako.ai · relatórios de segurança: veja SECURITY.md · mudanças: veja CHANGELOG.md

Licença

As skills e as configurações de cliente neste repositório são MIT — veja LICENSE. O serviço hospedado Adako é proprietário.