Opérations métierSource publique

Ads MCP Server

Plateforme de publicité digitale pour agents commerciaux et marketing ADK-Rust Enterprise. 19 outils MCP couvrant campagnes, groupes d'annonces, annonces/créatifs, budgets et enchères, audiences, métriques quotidiennes avec KPI dérivés…

Ouvrir la source Lisez le guide officiel ↗

Ce qu'il offre à un agent

Une capacité conçue spécifiquement derrière une connexion MCP unique.

Le serveur possède sa logique de domaine et publie un contrat d'outil qu'un client MCP peut découvrir. ADK-Rust peut charger ce contrat dans un agent, normaliser chaque schéma pour le fournisseur de modèle choisi, et garder le cycle de vie de la connexion en dehors de la logique métier de l'agent.

Hiérarchie des campagnes — campagnes (objectif, canal, budget quotidien) → groupes d'annonces (stratégie d'enchère + enchère/cible, audience) → annonces/créatifs.

Audiences — centres d'intérêt / remarketing / similaires / personnalisées avec taille estimée.

Métriques & KPI — ingestion quotidienne d'impressions/clics/dépenses/conversions/revenus ; CTR, CPC, CPA, CVR, ROAS dérivés au niveau groupe d'annonces et campagne consolidée.

Rythme budgétaire — dépenses du jour vs budget quotidien avec indicateur de rythme (sous-dépense / conforme / rythme élevé / budget épuisé).

Optimisation — suggestions basées sur règles par groupe d'annonces : augmenter les gagnants à ROAS élevé, couper/mettre en pause les groupes sous seuil ou sans conversion, signaler CTR faible, détecter CPA dépassant la cible…

Architecture

Comment Ads MCP Server s'intègre dans un système d'agent.

Le modèle n'a jamais besoin des détails d'implémentation ou des identifiants du système derrière le serveur. Il voit les définitions d'outils examinées. Le client MCP gère la découverte et les appels, tandis que le serveur conserve la propriété de la validation, de la politique et de la communication avec son système de domaine.

Agent ADK-Rust

Choisit une capacité dans le catalogue d'outils examiné.

→

Client MCP

Découvre les schémas, envoie des appels et reçoit du contenu typé.

→

Ads MCP Server

Valide la requête et possède 19 contrats d'outils documentés.

→

Système de domaine

Conserve l'API, les données, les identifiants et les règles métier derrière le serveur.

Connexion : stdio · Cadre serveur : ADK MCP SDK + rmcp

Diagramme d'architecture de Ads MCP Server depuis son dépôt officiel

Catalogue d'outils

Que peut demander un agent à Ads MCP Server ?

Chaque outil a un nom stable, un but lisible par l'humain, et un contrat d'entrée JSON découvert lors de l'initialisation MCP. Les classes de risque proviennent du manifeste du registre du projet lorsqu'il est disponible.

19 outils nommés

create_campaign

Créer une campagne (brouillon)

internal write

get_campaign

Obtenir une campagne par identifiant

read only

list_campaigns

Lister les campagnes par statut/canal

read only

set_campaign_status

Définir le statut d'une campagne (impacte les dépenses) — contrôlé

external write

set_budget

Définir le budget quotidien d'une campagne — contrôlé (dépenses)

external write

create_ad_group

Créer un groupe d'annonces sous une campagne

internal write

get_ad_group

Obtenir un groupe d'annonces par identifiant

read only

list_ad_groups

Lister les groupes d'annonces d'une campagne

read only

set_bid

Définir l'enchère/cible d'un groupe d'annonces — contrôlé (dépenses)

external write

create_ad

Créer une annonce/créatif

internal write

list_ads

Lister les annonces dans un groupe d'annonces

read only

create_audience

Créer une audience

internal write

Gouvernance

Comprendre l'effet de chaque outil.

Une connexion serveur hérite de l'autorité de ses identifiants et de son environnement de déploiement. Les déclarations ci-dessous proviennent du README de ce projet et du manifeste du registre MCP ; votre application décide toujours des outils qu'un agent reçoit et des endroits où une approbation est requise.

11 read only5 internal write3 external write

Trois écritures affectant directement les dépenses sont contrôlées (requires_approval, external_write) : set_budget, set_bid, set_campaign_status (mettre en pause/activer une campagne modifie les dépenses).…
optimize est en lecture seule — il recommande ; appliquer une recommandation passe par un outil contrôlé. Budgets et enchères sont gardés non négatifs ; les campagnes terminées sont finales.
Tout élément matériel est dans la piste d'audit (audit_log). Les données d'exemple sont fictives.

Surface MCP

Ce que la documentation actuelle déclare.

MCP peut transporter des outils, ressources, invites, résultats structurés, progression, annulation et travaux de longue durée. Cet enregistrement met en avant les fonctionnalités modernes du protocole explicitement mentionnées par ce dépôt.

Le README actuel se concentre sur sa surface d'outil. Vérifiez la source et les notes de version avant de compter sur des capacités MCP optionnelles au-delà de la découverte et de l'invocation d'outils.

ADK MCP SDKrmcpManifeste du registre

Installer et connecter

Suivez le point de départ documenté du projet.

Installez le serveur dans l'environnement qui possède ses identifiants et l'accès au domaine. Ajoutez-le à votre hôte MCP, vérifiez les outils découverts, et réduisez l'ensemble d'outils avant de le confier à un agent en production.

Installer

cargo install mcp-ads

Forme de connexion ADK-Rust

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

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

Les commandes et la configuration sont extraites du README public. Confirmez les prérequis, variables d'environnement et options spécifiques à la version dans la documentation officielle avant le déploiement.

Documentation officielle

Poursuivez avec la source de vérité des mainteneurs du projet.

Cette page fournit une carte accessible du serveur. Le dépôt reste la référence pour les schémas exacts, prérequis, configuration, exemples, tests, versions et mises à jour de sécurité.

Présentation ↗README.md JOURNAL DES MODIFICATIONS ↗CHANGELOG.md Architecture ↗docs/architecture.svg Problèmes et support ↗problèmes github.com

Continuez à explorer