Documentation développeur

Serveur MCP

Utilisez Augure dans les outils d’IA avec lesquels vous travaillez déjà. Un assistant compatible se connecte au serveur MCP d’Augure et peut appeler les modèles Augure comme outil, facturé à votre compte développeur Augure aux mêmes tarifs que l’API.

Point d’accès : https://mcp.augureai.ca/mcp

Ce que ça permet

Le Model Context Protocol permet à un assistant d’appeler des outils externes. Une fois le serveur Augure connecté, votre assistant peut confier une question ou un bloc de texte à un modèle Augure et utiliser la réponse. Son propre modèle continue de faire tout le reste.

Installer le serveur MCP ne remplace pas le modèle principal de votre assistant et ne change pas la politique de données de son fournisseur. Pour utiliser Augure comme modèle principal, passez par l’API compatible OpenAI dans votre IDE ou avec Augure Code.

Disponibilité : offert à tout compte développeur Augure avec une carte au dossier, une fois MCP activé dans le tableau de bord développeur. Le serveur utilise le transport Streamable HTTP et l’authentification se fait par clé MCP (en-tête bearer). Les assistants qui n’acceptent qu’une connexion OAuth, comme les connecteurs de claude.ai et de ChatGPT, ne sont pas pris en charge. Claude Code 2.1.283 a été vérifié le 26 septembre 2026; c’est le seul client vérifié. Les autres clients MCP n’ont pas été vérifiés.

Démarrage rapide

Créez un compte développeur avec une carte au dossier dans le tableau de bord développeur. L’utilisation MCP est facturée à ce compte.
Sélectionnez Activer MCP dans le tableau de bord. Le compte passe alors à la facturation par seuil (voir Tarifs plus bas).
Créez une clé MCP (aug_mcp_live_…). Choisissez les outils qu’elle peut appeler et une date d’expiration. Le secret n’est affiché qu’une fois.
Ajoutez le serveur à votre client (ci-dessous) en collant la clé à la place du texte de remplacement.
Appelez list_models, puis ask_augure.

Claude Code

terminal

claude mcp add --transport http augure https://mcp.augureai.ca/mcp \
  --header "Authorization: Bearer aug_mcp_live_…"

Premier appel ask_augure

ask_augure

{
  "prompt": "Reply with exactly MCP_OK",
  "model": "rosedale-1",
  "reasoning_effort": "low",
  "max_output_tokens": 256
}

Gardez la clé hors des fichiers partagés. Utilisez le champ secret de votre client ou une variable d’environnement quand c’est offert, et ne validez jamais une clé MCP dans un dépôt de projet. En cas de fuite, faites une rotation depuis le tableau de bord; l’ancien secret cesse de fonctionner en moins d’une minute.

Avant le premier appel payant : ask_augure est facturé au jeton. list_models et get_limits sont gratuits.

Outils

Trois outils sont offerts, avec un seul modèle : rosedale-1. Chaque clé en détient un sous-ensemble explicite; un outil non accordé n’est ni listé ni appelable. La recherche Web et la lecture de documents sont sur la feuille de route et ne sont pas offertes.

ask_augureFacturé au jeton

Envoie une requête texte, avec un contexte texte facultatif, à un modèle Augure et retourne la réponse, l’utilisation et le modèle réellement servi.

Arguments : prompt (requis, non vide, jusqu’à 100 000 caractères) · context (jusqu’à 200 000 caractères) · model (rosedale-1) · reasoning_effort (low, medium ou high) · max_output_tokens (≤ 8 192)

list_modelsGratuit

Les identifiants de modèles et les reasoning_efforts pris en charge avec cette clé. À appeler en premier.

Arguments : aucun

get_limitsGratuit

État de la facturation, dépenses du jour par rapport au plafond, limites d’appels, outils accordés à la clé et politique de résidence. Fonctionne même si la facturation est inactive, pour expliquer un refus.

Arguments : aucun

Les résultats contiennent à la fois un texte lisible et une charge structurée (réponse, modèle demandé et servi, jetons utilisés, identifiant de requête, région d’inférence). Les réponses de plus de 32 000 caractères sont tronquées avec un marqueur explicite. Le champ truncated vaut aussi true lorsque finish_reason vaut length. Limites : 30 appels d’outil par minute par clé; deux appels payants simultanés par compte.

Tarifs

MCP utilise votre compte de facturation développeur Augure. La connexion, la liste des modèles et la consultation des limites sont gratuites. Les appels aux modèles sont facturés selon les tarifs applicables aux jetons d’entrée et de sortie du modèle servi, exactement comme par l’API REST. La connexion MCP est sans frais supplémentaires et sans forfait distinct.

Activer MCP fait passer votre compte développeur à la facturation par seuil : votre carte est débitée chaque fois que l’utilisation atteint 50 $ CA, ou à la fin du mois, selon la première éventualité. Si votre compte développeur existait déjà, l’utilisation à ce jour est facturée immédiatement sur une facture finale pour l’ancienne période de facturation, puis la facturation par seuil commence.

Les frais de votre fournisseur d’assistant sont distincts.
Les crédits de votre forfait d’application Augure ne s’appliquent pas.
Sur les modèles qui raisonnent, les jetons de raisonnement sont facturés en sortie; la réponse visible n’est pas toute la génération. L’outil précise toujours un effort de raisonnement (par défaut low).
Un appel refusé avant l’exécution (authentification, schéma, facturation, budget) ne coûte rien. Un délai dépassé ou une réponse perdue après le début de la génération peut quand même être facturé.
L’utilisation apparaît dans le tableau de bord développeur avec le reste de votre utilisation de l’API.

Voir la grille tarifaire de l’API →

Où vont vos données

Le texte envoyé par un outil est traité par Augure au Canada. L’inférence des modèles pour MCP se fait avec rosedale-1, servi sur la capacité canadienne d’Augure, en Ontario. Si cette capacité est occupée, l’appel peut être servi par un second déploiement d’Augure en Ontario, qui peut utiliser un autre modèle; le résultat indique alors fallback: true. Les appels MCP sont réservés au Canada : si aucune capacité canadienne n’est disponible, l’appel échoue avec canadian_capacity_unavailable plutôt que de sortir du Canada. Le résultat indique la région d’inférence pour que vous puissiez le vérifier.

Votre assistant connecté reçoit à la fois le contexte que vous envoyez et les résultats retournés par Augure, selon les conditions de son fournisseur. Connecter Augure ne change ni l’endroit où s’exécute le modèle de votre assistant ni ce qu’il voit.

Augure journalise le nom de l’outil, l’identifiant de clé, les tailles et les durées. Les requêtes, le contexte et les réponses ne sont pas journalisés.

Erreurs et quoi faire

Code	Prochaine action
403 mcp_billing_setup_required	MCP n’est pas encore activé sur ce compte. Activez d’abord MCP dans le tableau de bord développeur, puis créez une clé MCP.
canadian_capacity_unavailable	La capacité canadienne n’est pas disponible pour le moment. Les appels MCP sont réservés au Canada : l’appel échoue au lieu d’être servi hors du Canada. Réessayez plus tard.
unsupported_reasoning_effort	Par MCP, rosedale-1 accepte low (par défaut), medium et high. none n’est pas pris en charge et est refusé avant la génération, sans frais.
empty_completion / reasoning_cutoff	Aucune réponse livrée; cet appel n’est pas facturé. Augmentez un budget de sortie trop court ou réduisez l’effort. Ce n’est pas un signal de panne de capacité.
concurrency_limit_exceeded	Deux appels payants sont déjà en cours pour ce compte. Attendez qu’un appel se termine.
401	Clé absente, invalide, révoquée ou expirée. Créez-en une ou faites une rotation dans le tableau de bord développeur.
403 mcp_key_not_allowed	Vous avez envoyé une clé MCP à l’API REST. Les clés MCP fonctionnent seulement avec le serveur MCP; utilisez une clé développeur (aug_sk_live_…) pour les appels directs à l’API.
billing_inactive	Ajoutez ou mettez à jour un mode de paiement dans le tableau de bord développeur. Les outils gratuits continuent de fonctionner.
model_unavailable / model_not_available	Aucun modèle n’est encore activé pour cette clé, ou l’identifiant n’est pas dans list_models.
quota_exceeded	Le plafond de dépenses du jour est atteint. Il se réinitialise à 0 h UTC.
budget_unavailable	Augure n’a pas pu vérifier votre budget; rien n’a été facturé. Réessayez dans environ 30 s.
rate_limited	Trop d’appels dans la minute. Le résultat indique retry_after_s.
timeout_or_cancelled	L’appel a dépassé son délai ou a été annulé. Une génération déjà commencée peut avoir été facturée; ne relancez pas automatiquement.