Connectez votre premier agent

1. Créez votre compte

Ouvrez my.sallyport.cloud. Cliquez sur « Continuer avec Google », ou inscrivez-vous par e-mail : cliquez sur « Continuer avec l’e-mail », saisissez votre e-mail et cliquez sur « Continuer ». Pour un nouvel e-mail, remplissez « Prénom », « Nom » et « Mot de passe », puis cliquez sur « Créer un compte ». Saisissez ensuite le code à 6 chiffres reçu et cliquez sur « Confirmer l’e-mail ».

La personne qui s’inscrit possède l’organisation et son premier espace de travail. Ajouter des clés et des agents demande le rôle de propriétaire ou d’administrateur.

2. Enregistrez une clé de service

Ouvrez Ajouter une clé de service. Ce guide prend GitHub : tapez-le dans « Service du catalogue » et choisissez GitHub API. Gardez « Production » sous « Environnement ».

Sous « Comment connecter GitHub API », choisissez « Jeton d’accès ». Cliquez sur « Créer la clé chez GitHub API », créez un jeton sur GitHub et collez-le. Cliquez sur « Enregistrer la clé ».

Sallyport vérifie le jeton auprès de GitHub en l’enregistrant. Dès ce moment, tous les agents de l’espace de travail peuvent utiliser la clé. L’autre voie, « Se connecter avec GitHub », vous envoie sur GitHub pour approuver ; le formulaire indique ce qu’il lui faut.

3. Créez un agent

Ouvrez Agents et cliquez sur « Nouvel agent ». Saisissez un « Nom », par exemple laptop-claude, puis cliquez sur « Créer l’agent ». La page de l’agent s’ouvre.

Sa liste « Accès » contient déjà la clé GitHub. Les nouvelles lignes exécutent chaque appel sans demander.

4. Connectez Claude Code

Sur la page de l’agent, « Connecter cet agent » a Claude Code sélectionné. Cliquez sur « Copier pour Claude Code ». Sallyport crée un jeton et copie la commande complète avec lui.

export SP_AGENT_TOKEN='<agent-token>'
claude mcp add --transport http --scope user sallyport https://mcp.sallyport.cloud/mcp --header "Authorization: Bearer $SP_AGENT_TOKEN"

Lancez-la dans un terminal, puis redémarrez Claude Code. La commande copiée contient le jeton lui-même ; l’exemple ci-dessus le lit dans SP_AGENT_TOKEN. Une fois l’ajout fait, claude mcp list affiche sallyport.

Le jeton ne s’affiche qu’une fois et figure sous « Jetons » sur la page de l’agent. Pour Cursor, Codex, Claude, ChatGPT et les autres clients, voir Clients MCP et serveurs distants.

5. Lancez le premier appel

Demandez à l’agent : « Lis mon profil GitHub via Sallyport. » Il trouve GitHub parmi ses outils et appelle github_read avec ces arguments :

{
  "method": "GET",
  "path": "/user"
}

Sallyport ajoute le jeton, appelle api.github.com et renvoie la réponse de GitHub. L’agent ne voit jamais le jeton. L’appel et son résultat apparaissent dans Activité.

6. Répondez à votre première approbation

Les appels passent sans demander tant que vous n’en décidez pas autrement. Sur la page de l’agent, dans la liste « Accès », activez « Demander à chaque appel » sur la ligne GitHub.

Demandez à l’agent de relire le profil. L’appel attend, et sa carte apparaît dans Approbations et sur toute page ouverte de la console. Si l’attente dure, l’agent vous montre le lien de la carte.

Cliquez sur « Approuver » : l’appel s’exécute et l’agent reçoit la réponse. « Refuser » l’arrête, et l’agent lit le motif que vous donnez. Les cartes peuvent aussi arriver dans ce navigateur, sur Telegram ou par e-mail : activez-le dans Notifications. Plus de détails dans Approbations.

Sans clé, l’agent la demande

Un agent peut joindre un service public que vous n’avez pas connecté. Il appelle http_request avec l’URL complète, ou request_access avec le nom du service et un purpose : une phrase qui dit pourquoi il en a besoin. Sallyport répond avec un lien pour vous.

{
  "method": "GET",
  "url": "https://api.stripe.com/v1/balance"
}

Le lien ouvre la demande dans Clé requise. Ajoutez la clé ou connectez-vous, puis cliquez sur « Accorder l’accès ». Tous les agents de l’espace de travail reçoivent la clé, et l’agent relance son appel.