MCP

Les serveurs MCP ajoutent des outils externes. Chaque serveur appartient à un profil. Configurez connexion et exposition, puis enregistrez. Probe est facultatif, sans être requis pour enregistrer ou activer.

Configurer depuis une conversation

Donnez à Anyy un point MCP précis ou une commande locale et demandez son ajout au profil actuel. La conversation utilise la CLI existante si les outils shell sont disponibles ; la configuration MCP n’est pas un outil modèle natif distinct. Utilisez le même profil dans conversation et Dashboard. Un chemin de profil CLI explicite est celui d’Anyy, pouvant différer du HOME shell.

Après enregistrement, actualisez pour inspecter ID, activation et connexion. Vous pouvez aussi ajouter ici puis demander l’utilisation au tour suivant. L’exposition codemode découvre/appelle par Codemode ; deferred utilise la recherche. Enregistrer une définition, voir son nom et appeler réellement un outil sont des vérifications distinctes. Un échec de connexion doit rester visible même après enregistrement réussi.

Ajouter un serveur dans Dashboard

Ouvrez Dashboard → MCP → Add MCP server.

1. Saisissez un Server ID stable avec lettres, chiffres, tirets ou traits de soulignement.
2. Choisissez stdio local ou http distant.
3. Saisissez commande et arguments ou URL MCP.
4. Définissez authentification fournisseur, options OAuth, en-têtes ou environnement au besoin.
5. Choisissez Exposure et les règles JSON ordonnées facultatives.
6. Sélectionnez Save, puis Probe au besoin.

La commande locale a les accès système de l’environnement Anyy. Les valeurs ordinaires environnement/en-têtes/OAuth gardent les chaînes saisies ; Save ne déduit pas de référence Secret d’un nom de champ. Utilisez une référence explicite pour les secrets gérés. Consultez les expressions.

La connexion partagée annonce la racine Workspace résidente, figée au démarrage du gestionnaire. Le répertoire de travail local est distinct. Consultez Initialisation et racines.

Prérequis de connexion

Les transports sont stdio et Streamable HTTP (http). sse séparé est rejeté ; HTTP peut encore porter des flux d’événements. Les points distants exigent HTTPS sauf HTTP en boucle locale.

Pour stdio, installez serveur et dépendances sur l’hôte Anyy. npx y exige Node.js/npm ; Anyy ne fournit ni ces environnements ni cette installation. Seul un environnement limité, dont PATH et HOME, est hérité ; définissez les autres valeurs dans env. HTTP n’exige pas Node.js local.

Paramètres et définitions de profil

La définition enregistrée et l’entrée projet effective peuvent venir de fichiers différents. Vérifiez la source avant édition ; consultez Profil et projet.

Utilisez le commutateur existant pour activer/désactiver. Dans Edit, choisissez l’opération de paramètres pour enregistrer seulement Exposure dans la source choisie ou son remplacement existant ; laissez transport et définition vides. Aucun serveur sans rapport n’est reconnecté, ni le serveur choisi pour une exposition modifiée. Utilisez une opération distincte de définition de profil pour transport, identifiants, description et règles. Ne combinez pas ces opérations.

Une erreur de connexion après sauvegarde n’annule pas le réglage. mcp reload reconnecte les valeurs chargées ; relire des fichiers manuels exige démarrage ou RPC session.reload inactif, sans nouveau test de connexion.

Exposition des outils

Valeur	Comportement
codemode	Par défaut ; découverte par Codemode
deferred	Découverte par recherche d’outils
direct	Déclaration directe au modèle
hidden	Exclu des découvertes modèle et Codemode

toolExposure remplace le défaut du serveur. Un nom exact prime ; sinon le premier joker correspondant gagne, donc l’ordre compte :

{"search":"direct","read*":"deferred","*":"hidden"}

MCP ne crée ni n’active d’ensembles personnels mcp-*. Les ensembles ordinaires et restrictions d’outils imposées par la session parente restent séparés.

Authentification HTTP

Sans en-tête Authorization ni référence fournisseur, Anyy utilise OAuth du serveur distant au besoin. Une référence fournisseur est un objet JSON :

{"provider":"provider-id"}

Les options OAuth sont un autre objet, par exemple {"clientId":"registered-client"}. Les anciens sélecteurs auth: oauth, header et none sont refusés. Stockez les en-têtes sensibles comme références de secrets, sans identifiants dans les URL.

Enregistrez puis choisissez Sign in dans le détail. Ouvrez l’autorisation ; si le navigateur ne joint pas Anyy, collez l’URL complète de redirection dans le formulaire. Annulez/quittez pour arrêter la connexion en attente. Alternative CLI : anyy mcp login SERVER_ID --timeout 300.

Pour déconnecter tout en gardant le serveur, utilisez anyy mcp logout SERVER_ID avec l’ID exact ; consultez Déconnexion. C’est une commande CLI, sans bouton Dashboard supplémentaire. Retirer une définition brute de profil efface aussi ses identifiants OAuth gérés. Pour le projet, utilisez le parcours CLI/fichier ; remove --local préserve les autorisations et agit après relecture. Propriété et protection des identifiants restent applicables.

État et outils

Le paramètre dit si le serveur est activé. La disponibilité distingue connecté, en attente, dégradé ou indisponible. La sonde retourne un inventaire tools avec name, visible_name, description, exposure et offered. Ce n’est ni une approbation ni une décision de liste d’autorisation.

OAuth HTTP par défaut n’impose pas de connexion à un serveur anonyme. Disponibilité et identifiants sont distincts : auth_mode: oauth peut coexister avec une connexion prête et des données OAuth not_loaded. Une absence initiale de jeton seule ne demande pas de réauthentification. Un défi réel, une autorisation expirée ou une déconnexion explicite gardent leur comportement normal.

Ouvrez Tools pour schémas et descriptions. Inspectez les événements de diagnostic masqués depuis la page ou la CLI.

Les ressources utilisent list_mcp_resources, list_mcp_resource_templates et read_mcp_resource. L’état affiche resources_advertised, prompts_advertised et server_capabilities ; anciens champs d’activation/posture/compte et commutateurs sont retirés. Consultez Ressources et modèles.

Les serveurs activés Codemode/différés figurent aussi dans le résumé borné mcp_servers. La description configurée prime sur la première ligne d’instructions. Un serveur en connexion peut figurer ; serveurs directs uniquement, cachés uniquement et désactivés sont omis.

Enregistrer une description ou changer l’exposition ne réécrit pas la demande active. Le résumé est capturé au début de chaque exécution et actualisé à la demande suivante. Consultez Résumés de serveurs.

CLI

anyy mcp add docs --command mcp-docs --exposure codemode
anyy mcp add remote --url https://example.com/mcp --auth '{"provider":"provider-id"}'
anyy mcp configure docs --exposure deferred
anyy mcp set docs description 'Documentation tools'
anyy mcp set docs toolExposure '{"read*":"deferred","*":"hidden"}'
anyy mcp test docs
anyy mcp status --json
anyy mcp show docs
# Only if the current docs server advertises this name and schema:
anyy mcp call docs.search --args '{"query":"Anyy"}'
anyy mcp disable docs
anyy mcp remove docs

add enregistre un serveur activé à connexion différée par défaut ; --disable l’enregistre désactivé. La configuration ne demande pas de sélection d’outils ni de sonde obligatoire.

Les anciens mcp.client.enabled, tools.include, tools.exclude, tools.trusted, --include et --activate-toolset sont retirés et rejetés. Migrez vers l’exposition. En RPC, les règles ordonnées voyagent dans la chaîne JSON tool_exposure puis deviennent l’unique valeur ordonnée toolExposure.

Dépannage

Problème	Étape suivante
Serveur activé indisponible	Inspectez les journaux et lancez anyy mcp test SERVER_ID
Configuration rejetée	Vérifiez types et retirez les anciens sélecteurs
OAuth demande une intervention	Lancez anyy mcp login SERVER_ID
Outil absent	Vérifiez activation, exposition et outils de découverte
Processus local ne démarrant pas	Vérifiez commande, arguments et environnement