Connecter un assistant

Donner à un assistant IA l'adresse de votre Asterobot, avec un mot de passe quand vous en avez défini un, et vérifier qu'il voit les outils.

Read this page in English

Connecter un assistant, c'est lui donner une adresse. Asterobot n'a besoin d'aucun réglage pour cela : le point d'accès est actif dès qu'Asterobot démarre.

L'adresse

Le point d'accès est /mcp sur le port d'Asterobot, celui de server.listenAddress :

L'assistant doit tourner sur le même ordinateur qu'Asterobot, ou l'atteindre comme Asteroboard le fait depuis un autre appareil. Un assistant qui tourne sur un site web plutôt que sur votre ordinateur ne peut pas atteindre 127.0.0.1 ; voir Depuis une autre machine.

Claude Code

Dans un terminal, lancez :

claude mcp add --transport http asterobot http://127.0.0.1:8080/mcp

Puis démarrez une conversation et posez-lui une question sur Asterobot, par exemple « liste mes bots ». La première fois qu'il utilise un outil qui modifie quelque chose, il vous demande la permission.

claude mcp list affiche les serveurs qu'il connaît et s'il les atteint.

Autres assistants

Tout assistant qui prend en charge MCP en HTTP prend la même adresse, appelée l'URL du serveur. Beaucoup la lisent dans un fichier JSON avec une entrée de ce genre, sous un nom que vous choisissez :

{
  "mcpServers": {
    "asterobot": {
      "url": "http://127.0.0.1:8080/mcp"
    }
  }
}

Le fichier exact et sa forme dépendent de l'assistant : cherchez « MCP » et « HTTP » dans sa documentation. Deux choses à savoir quand il pose la question :

• Le transport est HTTP, parfois appelé streamable HTTP. Ce n'est ni l'ancien transport SSE, ni une commande à exécuter.
• Asterobot ne garde aucune session entre deux appels. Les assistants conçus pour la version actuelle du protocole fonctionnent ; un assistant très ancien qui exige un identifiant de session du serveur ne se connectera pas.

Avec un mot de passe

Quand server.basicAuth contient un identifiant et un mot de passe, /mcp les exige aussi, sous la forme d'un en-tête Authorization. Sa valeur est Basic suivi de l'identifiant, deux-points et le mot de passe, encodés en base64. Pour encoder alice:s3cret :

echo -n 'alice:s3cret' | base64

[Convert]::ToBase64String([Text.Encoding]::UTF8.GetBytes("alice:s3cret"))

Donnez ensuite l'en-tête à l'assistant. Avec Claude Code :

claude mcp add --transport http asterobot http://127.0.0.1:8080/mcp --header "Authorization: Basic YWxpY2U6czNjcmV0"

Les autres assistants ont une entrée headers à côté de l'URL dans leur fichier de configuration.

Depuis une autre machine

Un assistant sur un autre ordinateur atteint Asterobot comme Asteroboard le fait depuis un autre appareil, et avec les mêmes précautions : Asterobot sur une machine distante et Sécurité s'appliquent mot pour mot. Un tunnel SSH est le plus simple : il garde Asterobot sur 127.0.0.1, et l'adresse reste http://127.0.0.1:8080/mcp sur la machine où tourne l'assistant.

Quand Asterobot écoute sur une adresse réseau sans authentification basique, sa console le dit au démarrage :

The MCP is reachable from the network without authentication: set server.basicAuth or listen on loopback

C'est la même exposition qu'Asteroboard a déjà dans cette installation, dite une fois à voix haute.

Vérifier que ça fonctionne

Au démarrage d'Asterobot, sa console et son terminal affichent une ligne sur le point d'accès :

Demandez ensuite à l'assistant de vérifier qu'Asterobot répond : il a un outil pour cela, get-runtime-ping, dont la réponse est pong. S'il dit qu'il ne peut pas atteindre le serveur, vérifiez l'adresse et le port, et qu'Asterobot tourne.

Suite : Outils, événements et limites.