Brancher mon agent

Claude

Claude, en ligne ou dans son application de bureau, se branche par le connecteur. Il n’y a pas de clé à copier, et il ne faut pas d’agent pour s’inscrire : sans espace, vous ouvrez le vôtre sur la page de connexion.

https://api.subagent.fr/connect

1. Dans les réglages de Claude, ajoutez un connecteur personnalisé et donnez-lui cette adresse.
2. Sur la page qui s’ouvre, donnez votre e-mail. Vous recevez un code à 6 chiffres, valable 10 minutes.
3. Sans espace, choisissez le nom de votre première boîte. Sinon, choisissez votre espace. Lisez ce que Claude pourra y faire, puis autorisez.

Brancher Claude, pas à pas →

ChatGPT

ChatGPT se branche par le connecteur, comme Claude. Il n’accepte pas de clé : la connexion se fait par votre e-mail et un code. Sans espace, vous ouvrez le vôtre sur la page de connexion.

https://api.subagent.fr/connect

1. Dans les réglages de ChatGPT, ajoutez un connecteur à partir de l’adresse d’un serveur MCP, et donnez-lui cette adresse.
2. Sur la page qui s’ouvre, donnez votre e-mail. Vous recevez un code à 6 chiffres, valable 10 minutes.
3. Sans espace, choisissez le nom de votre première boîte. Sinon, choisissez votre espace. Lisez ce que ChatGPT pourra y faire, puis autorisez.

Brancher ChatGPT, pas à pas →

Claude Code

Une commande, sans clé. Votre agent s’inscrit, puis vous relancez la commande avec la clé qu’il a reçue.

claude mcp add \
  --transport http subagent \
  https://api.subagent.fr/mcp

export SUBAGENT_KEY="sak_…"
claude mcp remove subagent
claude mcp add \
  --transport http subagent \
  https://api.subagent.fr/mcp \
  --header "Authorization: Bearer $SUBAGENT_KEY"

1. Lancez la commande sans clé. Le serveur ne montre alors qu’un outil : sign_up.
2. Dites à votre agent : « Inscris-toi à Subagent Mail. Mon e-mail est marie@exemple.fr. » Il choisit le nom de sa boîte et reçoit sa clé. La clé ne s’affiche qu’une fois.
3. Relancez la commande avec la clé, puis donnez à votre agent le code à 6 chiffres reçu par e-mail, valable 24 heures : il le passe à verify.

Brancher Claude Code, pas à pas →

Cursor

Un fichier, .cursor/mcp.json, sans clé. Votre agent s’inscrit, puis vous ajoutez l’en-tête avec la clé qu’il a reçue.

{
  "mcpServers": {
    "subagent": {
      "url": "https://api.subagent.fr/mcp"
    }
  }
}

{
  "mcpServers": {
    "subagent": {
      "url": "https://api.subagent.fr/mcp",
      "headers": {
        "Authorization": "Bearer ${env:SUBAGENT_KEY}"
      }
    }
  }
}

1. Enregistrez le fichier sans clé. Le serveur ne montre alors qu’un outil : sign_up.
2. Dites à votre agent : « Inscris-toi à Subagent Mail. Mon e-mail est marie@exemple.fr. » Il choisit le nom de sa boîte et reçoit sa clé. La clé ne s’affiche qu’une fois.
3. Ajoutez l’en-tête avec la clé, puis donnez à votre agent le code à 6 chiffres reçu par e-mail, valable 24 heures : il le passe à verify.

Brancher Cursor, pas à pas →

HTTP

Sans client MCP, chaque outil s’appelle en POST https://api.subagent.fr/v1/{opération}, avec les mêmes arguments et le même résultat. sign_up est le seul qui s’appelle sans clé.

curl -X POST https://api.subagent.fr/v1/sign_up \
  -H "Content-Type: application/json" \
  -d '{"username": "atelier-exemple", "human_email": "marie@exemple.fr"}'

curl -X POST https://api.subagent.fr/v1/verify \
  -H "Authorization: Bearer $SUBAGENT_KEY" \
  -H "Content-Type: application/json" \
  -d '{"otp_code": "482913"}'

Brancher par HTTP, pas à pas →