Serveur MCP
Connectez Danubia à votre agent IA via le Model Context Protocol : récupérer et lire n'importe quelle page web devient un outil que votre agent peut appeler à la demande.
Danubia parle le Model Context Protocol : connectez votre agent IA à https://app.danubia.tech/api/mcp et la récupération de n'importe quelle page web devient l'un de ses outils. Demandez un résumé, une comparaison, une vérification de faits ou une source pour un brouillon ; l'agent récupère la page lui-même et travaille à partir du même markdown propre que produit l'API.
Pourquoi le connecter
Tout ce que vous faites aujourd'hui en copiant-collant une URL dans le bac à sable de l'API, vous pouvez le demander directement à votre agent :
- Recherche et vérification des faits. Votre agent lit une page avant de répondre, au lieu de travailler à partir de connaissances datées ou d'un extrait de recherche délavé.
- Rédacteurs et éditeurs. Demandez une note de synthèse, un plan ou une réécriture d'un article en ligne ; l'agent récupère lui-même la source.
- Pipelines de connaissances et RAG. Récupérez des pages en markdown propre à la demande, alimentez votre propre index et gardez-le à jour sans maintenir un scraper séparé.
- Surveillance. Votre agent peut vérifier une page régulièrement, comparer les changements et ne vous parler que de ce qui compte.
Comme chaque récupération passe par le pipeline Danubia habituel, vous obtenez les mêmes garanties que l'API REST : crawling respectueux (robots.txt appliqué), mise en cache pour que les requêtes répétées coûtent peu, rendu JavaScript quand vous le demandez, et facturation comptabilisée depuis le même solde de crédits.
Comment ça marche
- Votre agent demande l'accès à Danubia ; vous l'approuvez via la connexion et le flux de consentement du tableau de bord. Avec le flux OAuth 2.1 de better-auth, aucune clé API ne quitte votre agent.
- L'agent reçoit un jeton pour le point de terminaison ci-dessous et découvre les outils disponibles.
- Chaque appel
fetch_urlemprunte le même pipeline que l'API REST : URL normalisée, robots.txt, mise en cache, rendu et facturation sont partagés par construction.
Connexion
Danubia parle le flux OAuth standard du MCP : la première connexion ouvre les pages de connexion et de consentement Danubia dans votre navigateur, et votre client stocke le jeton qu'il reçoit. Les jetons sont limités à la portée mcp:tools : l'agent connecté ne peut appeler que des outils, rien d'autre. Le point de terminaison est https://app.danubia.tech/api/mcp.
Claude Code
Une seule commande suffit — Claude Code découvre la prise en charge OAuth du serveur (enregistrement dynamique de client et CIMD sont tous deux pris en charge) et ouvre le flux dans votre navigateur à la première utilisation :
claude mcp add --transport http danubia https://app.danubia.tech/api/mcp
Pour vous reconnecter ou vous déconnecter plus tard : claude mcp login danubia et claude mcp logout danubia.
Opencode
Opencode exécute le même flux OAuth (enregistrement dynamique de client) la première fois qu'il appelle un outil. Ajoutez un serveur distant à votre configuration OpenCode :
{
"$schema": "https://opencode.ai/config.json",
"mcp": {
"danubia": {
"type": "remote",
"url": "https://app.danubia.tech/api/mcp"
}
}
}
À la première utilisation, Opencode vous invite à autoriser dans votre navigateur ; vous pouvez aussi déclencher le flux vous-même avec opencode mcp auth danubia, et vérifier l'état avec opencode mcp list.
Tout autre client MCP
Le point de terminaison est un serveur MCP HTTP sans état standard, donc tout client MCP qui parle HTTP fonctionne. La forme générique de configuration client est :
{
"mcpServers": {
"danubia": {
"type": "http",
"url": "https://app.danubia.tech/api/mcp",
"auth": "oauth"
}
}
}
L'outil fetch_url
Récupère l'URL donnée et renvoie le contenu propre et extrait de la page — markdown par défaut — précédé d'un court préambule (titre, statut HTTP, redirections, fraîcheur du cache, crédits consommés). Danubia supprime la navigation et les publicités avant de vous montrer la page : demander à votre agent de « récupérer le contenu de la page X » donne le même texte lisible que l'API, pas le HTML brut.
| Argument | Défaut | Description |
|---|---|---|
url (obligatoire) | — | La page à récupérer. Normalisée au décodage, exactement comme pour l'API REST : forme canonique, identifiants de session et fragments supprimés. |
maxAge | 86400 (24 h) | Ancienneté maximale du cache en secondes ; 0 force une récupération fraîche, plafonné à 30 jours. |
format | markdown | Le format du contenu : markdown (par défaut pour les agents), html, plain ou raw. |
fetchMode | http | http pour du HTTP simple, ou browser pour les pages rendues en JavaScript. |
allowStale | true | Sert le contenu en cache quand le rafraîchissement échoue (stale: true dans la réponse), ou échoue la requête. |
L'outil renvoie le contenu principal de la page sous forme de texte précédé d'un court préambule : l'URL normalisée, le format, le statut HTTP, l'indication d'ancienneté et les crédits consommés. Les erreurs reviennent comme des erreurs d'outil que votre agent peut lire.
Et ensuite
- Parcourez la référence de l'API REST pour tous les formats et options derrière l'outil.
- Découvrez l'API par lots quand vous avez besoin de milliers de pages, pas d'une seule.
- Commencez avec une clé API pour les intégrations hors MCP.