Operações de negóciosCódigo-fonte público

Ads MCP Server

Plataforma de publicidade digital para agentes de vendas e marketing do ADK-Rust Enterprise. 19 ferramentas MCP cobrindo campanhas, grupos de anúncios, anúncios/criações, orçamentos e lances, públicos, métricas diárias com KPIs derivados…

Abrir o código-fonte Leia o guia oficial ↗

O que ele oferece a um agente

Uma capacidade feita sob medida por trás de uma conexão MCP.

O servidor possui sua lógica de domínio e publica um contrato de ferramenta que um cliente MCP pode descobrir. O ADK-Rust pode carregar esse contrato em um agente, normalizar cada esquema para o provedor de modelo escolhido e manter o ciclo de vida da conexão fora da lógica de negócio do agente.

Hierarquia de campanhas — campanhas (objetivo, canal, orçamento diário) → grupos de anúncios (estratégia de lance + lance/objetivo, público) → anúncios/criações.

Públicos — interesse / remarketing / lookalike / personalizado com tamanho estimado.

Métricas e KPIs — ingestão diária de impressões/cliques/gastos/conversões/receita; CTR, CPC, CPA, CVR, ROAS derivados no nível de grupo de anúncios e campanha consolidada.

Controle de orçamento — gasto do dia vs orçamento diário com indicador de ritmo (subgasto / no_prazo / ritmo_alto / orçamento_esgotado).

Otimização — sugestões baseadas em regras por grupo de anúncios: ampliar vencedores com alto ROAS, cortar/pausar grupos abaixo do ponto de equilíbrio ou sem conversão, sinalizar CTR baixo e controlar CPA acima do alvo…

Arquitetura

Como Ads MCP Server se encaixa em um sistema de agente.

O modelo nunca precisa dos detalhes de implementação ou credenciais do sistema por trás do servidor. Ele vê definições de ferramentas revisadas. O cliente MCP lida com descoberta e chamadas, enquanto o servidor mantém a propriedade da validação, política e comunicação com seu sistema de domínio.

Agente ADK-Rust

Escolhe uma capacidade do catálogo de ferramentas revisado.

→

Cliente MCP

Descobre esquemas, envia chamadas e recebe conteúdo tipado.

→

Ads MCP Server

Valida a solicitação e possui 19 contratos de ferramentas documentados.

→

Sistema de domínio

Mantém a API, dados, credenciais e regras de negócio por trás do servidor.

Conexão: stdio · Framework do servidor: ADK MCP SDK + rmcp

Diagrama de arquitetura de Ads MCP Server do seu repositório oficial

Catálogo de ferramentas

O que um agente pode pedir para Ads MCP Server fazer?

Cada ferramenta tem um nome estável, um propósito legível por humanos e um contrato de entrada JSON descoberto durante a inicialização MCP. Classes de risco vêm do manifesto do registro do projeto quando disponível.

19 ferramentas nomeadas

create_campaign

Criar uma campanha (rascunho)

internal write

get_campaign

Obter campanha por id

read only

list_campaigns

Listar campanhas por status/canal

read only

set_campaign_status

Definir status da campanha (afeta gastos) — controlado

external write

set_budget

Definir orçamento diário da campanha — controlado (gastos)

external write

create_ad_group

Criar grupo de anúncios em uma campanha

internal write

get_ad_group

Obter grupo de anúncios por id

read only

list_ad_groups

Listar grupos de anúncios em uma campanha

read only

set_bid

Definir lance/objetivo de grupo de anúncios — controlado (gastos)

external write

create_ad

Criar anúncio/criação

internal write

list_ads

Listar anúncios em um grupo de anúncios

read only

create_audience

Criar um público

internal write

Governança

Entenda o efeito de cada ferramenta.

Uma conexão de servidor herda a autoridade de suas credenciais e do ambiente de implantação. As declarações abaixo vêm do README deste projeto e do manifesto do registro MCP; sua aplicação ainda decide quais ferramentas um agente recebe e onde a aprovação é necessária.

11 read only5 internal write3 external write

Três gravações afetam diretamente gastos e são controladas (requires_approval, external_write): set_budget, set_bid e set_campaign_status (pausar/ativar campanha altera gastos).
optimize é somente leitura — recomenda; aplicar recomendação passa por ferramenta controlada. Orçamentos e lances são protegidos para não negativos; campanhas encerradas são finais.
Tudo relevante está na trilha de auditoria (audit_log). Dados de exemplo são fictícios.

Superfície MCP

O que a documentação atual declara.

O MCP pode transportar ferramentas, recursos, prompts, resultados estruturados, progresso, cancelamento e trabalhos de longa duração. Este registro destaca os recursos modernos do protocolo explicitamente mencionados por este repositório.

O README atual concentra-se em sua superfície de ferramentas. Verifique o código-fonte e as notas de versão antes de confiar em capacidades MCP opcionais além da descoberta e invocação de ferramentas.

ADK MCP SDKrmcpManifesto do registro

Instalar e conectar

Siga o ponto de partida documentado do projeto.

Instale o servidor no ambiente que possui suas credenciais e acesso ao domínio. Adicione-o ao seu host MCP, verifique as ferramentas descobertas e restrinja o conjunto de ferramentas antes de entregá-lo a um agente de produção.

Instalar

cargo install mcp-ads

Formato de conexão ADK-Rust

let toolset = McpToolset::from_stdio(
    "mcp-ads",
    ["mcp-ads"],
).await?;

let agent = LlmAgentBuilder::new("agent")
    .tools(toolset.tools().await?)
    .build()?;

Comandos e configurações são extraídos do README público. Confirme pré-requisitos, variáveis de ambiente e opções específicas da versão na documentação oficial antes da implantação.

Documentação oficial

Continue com a fonte de verdade dos mantenedores do projeto.

Esta página fornece um mapa acessível do servidor. O repositório permanece autoritativo para esquemas exatos, pré-requisitos, configuração, exemplos, testes, versões e atualizações de segurança.

Visão geral ↗README.md Registro de alterações ↗CHANGELOG.md Arquitetura ↗docs/architecture.svg Problemas e suporte ↗problemas no github.com

Continue explorando