Serveur MCP

Utiliser vos agents FORGE depuis Claude Code, Cursor, Codex, Claude.ai ou ChatGPT : installation, authentification, outils et ressources.

Le serveur MCP de FORGE expose vos agents aux assistants compatibles. Depuis votre éditeur ou votre conversation, vous créez un agent, lancez un run, suivez son avancement et lisez le rapport sans changer d'outil.

Adresse et authentification

Adresse du serveur (HTTP streamable) : http://localhost:4100/mcp.
OAuth 2.1 : le client découvre le serveur d'autorisation via /.well-known/oauth-protected-resource, puis vous validez l'accès dans le navigateur.
Clé API : en-tête Authorization: Bearer fk_live_…. Créez une clé dédiée, limitée aux scopes utiles.
Scopes disponibles : agents:read, agents:write, runs:write, billing:read, keys:write.

Installation

Claude Code : une commande, ci-dessous.
Cursor : ajoutez le serveur dans ~/.cursor/mcp.json, ou .cursor/mcp.json à la racine du projet. Sans headers, Cursor passe par OAuth.
Codex : ajoutez la section ci-dessous à ~/.codex/config.toml ; la clé est lue dans la variable FORGE_API_KEY.
Claude.ai : Paramètres, puis Connecteurs, puis Ajouter un connecteur personnalisé. Collez http://localhost:4100/mcp ; la connexion se fait par OAuth.
ChatGPT : Paramètres, puis Applications et connecteurs, puis Créer (mode développeur). Indiquez http://localhost:4100/mcp et choisissez l'authentification OAuth.

# OAuth (recommandé)
claude mcp add --transport http forge http://localhost:4100/mcp

# Avec une clé API
claude mcp add --transport http forge http://localhost:4100/mcp --header "Authorization: Bearer $FORGE_API_KEY"

{
  "mcpServers": {
    "forge": {
      "url": "http://localhost:4100/mcp",
      "headers": { "Authorization": "Bearer fk_live_…" }
    }
  }
}

# ~/.codex/config.toml
[mcp_servers.forge]
url = "http://localhost:4100/mcp"
bearer_token_env_var = "FORGE_API_KEY"

Outils disponibles

Domaine	Outils
Agents	`list_agents`, `get_agent`, `create_agent`, `validate_agent`, `agent_from_sop`, `apply_agent_manifest`, `clone_agent`, `list_catalog`, `preview_plan`
Runs	`estimate_run`, `run_agent`, `get_run`, `wait_run`, `control_run`, `cancel_run`
Batches et campagnes	`create_batch`, `get_batch_results`, `create_campaign`, `approve_campaign`
Catalogue	`list_skills`, `create_skill`, `list_tools`
Compte	`get_balance`, `create_key`

Ressources

forge://agents/{id} : configuration de l'agent, en JSON.
forge://runs/{id}/report : rapport du run, en Markdown.
forge://runs/{id}/live : lien vers la vue Live du run, à ouvrir dans le navigateur.

Exemple d'usage

Dans Claude Code, demandez : « Avec l'agent Vérification de société, vérifie ACME SAS en effort low et résume les risques. » L'assistant appelle estimate_run, puis run_agent et wait_run, et lit le rapport via forge://runs/{id}/report. Ouvrez le lien Live pour regarder l'agent travailler pendant ce temps.