Claude Code

Claude Code se connecte seul à Sallyport : aucun jeton à copier, rien à préparer d’abord dans la console. Un jeton de la console fonctionne aussi, pour un fichier de projet partagé dans git.

Connectez-le

• Lancez la commande ci-dessous dans un terminal. --scope user ajoute Sallyport à tous vos projets.
• Lancez claude mcp login sallyport, ou tapez /mcp dans Claude Code et choisissez sallyport. Votre navigateur ouvre Sallyport.
• Connectez-vous ou créez un compte, puis cliquez sur « Autoriser » sur l’écran de consentement. L’écran indique « Après votre autorisation, vous revenez dans une app de cet ordinateur » : cette app, c’est Claude Code.

claude mcp add --transport http --scope user sallyport https://mcp.sallyport.cloud/mcp

Cliquer sur « Autoriser » crée un agent au nom du client. L’agent d’un propriétaire ou d’un administrateur démarre avec toutes les connexions de l’espace de travail. Celui d’un membre démarre sans aucune, et un administrateur les ajoute dans « Accès ». Se reconnecter plus tard demande un clic sur « Reconnecter ».

Connexion avec un jeton

Claude Code accepte aussi un jeton d’agent envoyé dans un en-tête. La console écrit toute la commande pour vous, jeton compris.

• Dans la console, ouvrez Agents, cliquez sur « Nouvel agent », saisissez un nom et cliquez sur « Créer l’agent ».
• Sur la page de l’agent, dans « Connecter cet agent », laissez « Claude Code » sélectionné et cliquez sur « Copier pour Claude Code ». La copie contient le jeton que vous venez de créer sur cette page, ou un nouveau.
• Exécutez la commande copiée dans un terminal et redémarrez Claude Code. claude mcp list indique que sallyport est connecté.

claude mcp add --transport http --scope user sallyport https://mcp.sallyport.cloud/mcp \
  --header "Authorization: Bearer YOUR_AGENT_TOKEN"

--scope user rend Sallyport disponible dans tous vos projets et garde le jeton dans ~/.claude.json, hors de vos dépôts.

Pour vous passer du terminal, choisissez « Coller dans Claude » et cliquez sur « Copier le message pour Claude ». Collez le message dans un chat Claude Code, et Claude exécute la commande lui-même.

Seuls les propriétaires et les administrateurs créent des agents. Un nouvel agent démarre avec toutes les connexions de son espace de travail, et sa liste « Accès » sur la page de l’agent change cela.

Partagez-le par un fichier de projet

Un .mcp.json de projet part dans git avec le code. Claude Code développe ${VAR} dans ses en-têtes : le fichier nomme donc une variable, et chaque développeur garde le jeton dans son propre environnement.

{
  "mcpServers": {
    "sallyport": {
      "type": "http",
      "url": "https://mcp.sallyport.cloud/mcp",
      "headers": { "Authorization": "Bearer ${SP_AGENT_TOKEN}" }
    }
  }
}

Définissez SP_AGENT_TOKEN dans le shell qui lance Claude Code. L’option « .mcp.json » de la console copie le même fichier avec le jeton écrit dedans, et cette version reste hors de git.

Distinguez les sessions

Plusieurs sessions Claude Code peuvent partager un jeton. Dans « Identifier chaque session Claude Code », cliquez sur « Copier le hook de session pour Claude » et collez-le dans Claude Code. Chaque appel indique alors la session et le dossier d’où il vient.

Ce que voit l’agent

stripe_read     Stripe API (api.stripe.com/v1), reading only. Key: stripe-live.
stripe_write    Stripe API (api.stripe.com/v1). Key: stripe-live. For reads use stripe_read.
http_request    For a host in your list use its own tool.
list_access     Every service you can reach, one short entry each.
get_call        The state of a call by call_id, at once.

Une connexion à une API web donne deux outils : _read pour les lectures et _write pour tout le reste. Un serveur où l’agent lance des commandes donne un outil _exec. Une base de données donne _query et _execute, et un serveur MCP distant apporte ses propres outils. Chaque description nomme la clé et dit ce qui passe directement, l’agent connaît donc son accès avant le premier appel.

Quand un appel attend une personne

Par défaut, les appels passent directement. Un appel attend là où vous avez activé « Demander à chaque appel » ou mis une classe sur « Approbation requise », dans « Accès » de l’agent. Il attend aussi quand il dépasse un budget que vous avez fixé dans Limites.

Tant que la carte est ouverte, Sallyport garde l’appel en vie jusqu’à 4 minutes et signale sa progression toutes les 10 secondes. En session interactive, Claude Code passe l’appel en arrière-plan après 2 minutes et livre la réponse à son arrivée.

Pas de réponse en 4 minutes ? L’agent reçoit approve_url et call_id, vous montre le lien et répète l’appel avec ce call_id une fois que vous avez répondu. Le service est appelé une seule fois. Par défaut, la carte reste ouverte une heure. Voyez Approbations pour savoir où arrivent les cartes.

Laissez MCP_TOOL_TIMEOUT et le timeout d’un serveur non définis, ou mettez-les au-dessus de 240000. Une valeur plus basse coupe l’attente dans Claude Code, et l’agent perd le lien et le call_id.