Référence des outils MCP

La surface formelle des outils intégrés 2.0.2 gérée par les clés MCP contient exactement cinq noms :

Les Custom Tools publiés peuvent étendre la collection d’outils d’une base liée, mais ne constituent pas des outils intégrés supplémentaires.

Parcours de découverte recommandé

Utilisez la découverte de métadonnées lorsque le client ne possède pas déjà une représentation fiable de la structure. Les outils de schéma s’exécutent dans le contexte de base de la clé authentifiée, sans accepter de chaîne de connexion fournie par le client.

get_schemas

Retourne les schémas signalés par le runtime de métadonnées du moteur pour la base liée à la clé MCP.

Paramètres : aucun.

Résultat en succès : noms de schémas joints par des virgules.

Autorisation et limites :

• la clé doit être autorisée à utiliser get_schemas lorsqu’une liste d’outils explicite existe ;
• le moteur et la connexion doivent avoir été résolus depuis la clé authentifiée ;
• l’opération acquiert le limiteur de concurrence SQL partagé ;
• succès et échec sont écrits dans l’audit sous l’action mcp.get_schemas.

L’outil n’accepte ni identifiant de base ni chaîne de connexion fournis par le modèle.

get_tables

get_tables(schemaName: string)

Retourne les tables signalées par le moteur dans le schéma demandé, filtrées par la liste blanche de la clé MCP lorsqu’elle est configurée.

Si des métadonnées sémantiques existent pour l’entrée Database Management liée, chaque table visible peut aussi inclure :

• nom d’affichage ;
• description ;
• synonymes ;
• descriptions de métriques limitées à cette table.

Résultat en succès : chaîne séparée par des virgules. Les éléments peuvent donc être plus riches que de simples noms physiques.

Action d’audit : mcp.get_tables.

get_columns

get_columns(schemaName: string, tableName: string)

Le serveur vérifie d’abord que la table qualifiée demandée est autorisée par la clé MCP. Il lit ensuite les métadonnées de colonnes du moteur et sérialise un tableau JSON.

Chaque objet ColumnInfo 2.0.2 expose :

L’enrichissement peut ajouter noms d’affichage, descriptions, synonymes et descriptions de relations dans Description. Le contexte relationnel n’est inclus que si les deux tables de la relation sont autorisées par la liste blanche de la clé.

Action d’audit : mcp.get_columns.

execute_query_sql

execute_query_sql(sql: string)

Accepte une instruction SQL SELECT. La description publique 2.0.2 mentionne explicitement JOIN, WHERE, GROUP BY, HAVING, ORDER BY, LIMIT/OFFSET, DISTINCT, CTE, sous-requêtes et UNION/INTERSECT/EXCEPT.

La requête passe par le runtime de requête typé F#. Selon les capacités, des faits comme les tables référencées, la présence de CTE et de sous-requêtes sont collectés dans le même parcours gouverné et utilisés comme éléments de preuve d’audit.

Résultat en succès : sérialisation JSON de la collection de lignes retournée.

Résultat en échec : texte commençant par Execution failed: suivi du message d’erreur. Une annulation demandée par l’appelant est propagée au lieu d’être convertie en résultat normal.

Frontières runtime :

• liste d’outils MCP ;
• liaison clé MCP → base ;
• liste blanche de tables ;
• politique courante de sécurité/requête ;
• limiteur de concurrence SQL ;
• contrôles de capacité SQL source/cible ;
• événement d’audit mcp.query.executed avec opération, durée, lignes retournées et faits issus du compilateur.

Consultez Référence du support SQL pour un résumé lisible des capacités.

execute_dml_sql

execute_dml_sql(sql: string)

L’entrée visible via MCP est SQL. Le McpServer et le token d’annulation utilisés par la méthode .NET sont de l’infrastructure injectée par le runtime, pas des champs fournis par l’agent.

Les classes d’instructions prises en charge dans le chemin MCP DML 2.0.2 sont :

Pour UPDATE et DELETE, l’approbation est liée à l’ensemble exact de clés primaires et le code de commit revérifie les identités de lignes dans la transaction. Pour INSERT VALUES, l’approbation est liée au payload littéral immuable et à la commande compilée exacte, puis le commit vérifie le nombre de lignes du payload approuvé.

Si l’humain refuse ou si la validation ne peut pas aboutir, la mutation n’est pas validée. Les événements utilisent mcp.dml.executed et enregistrent l’opération, la durée, les lignes affectées, l’état d’approbation et, le cas échéant, la catégorie d’erreur.

Consultez Safe DML pour le protocole complet.

Erreurs communes aux outils intégrés

Les causes fréquentes sont :

• contexte d’autorisation MCP absent ;
• outil absent de la liste explicite de la clé ;
• moteur ou connexion invalide ;
• limite de concurrence incapable d’accorder un lease (Server busy) ;
• table hors de la liste blanche ;
• SQL vide, non pris en charge, refusé par la politique ou par une frontière de capacité ;
• échec d’exécution du moteur.

Les outils retournent volontairement des erreurs bornées au lieu de revenir vers une exécution libre chez le moteur.

Custom Tools

Les Custom Tools publiés sont chargés depuis l’entrée Database Management liée à la clé et peuvent être sélectionnés dans le même AllowedTools. Leur invocation continue de passer par la liaison de base, la liste blanche, la politique de sécurité, les contrôles de concurrence, l’audit et, pour DML, le pipeline d’approbation.

Consultez Outils personnalisés.

Les métadonnées sémantiques ne sont pas un sixième outil intégré

Le dépôt 2.0.2 contient une implémentation de gestion sémantique, mais le registre formel des outils intégrés et la gestion des clés Admin reconnaissent les cinq outils listés ici. La documentation traite donc les métadonnées sémantiques comme une capacité du plan de contrôle consommée par la découverte de schéma, et non comme un contrat MCP intégré supplémentaire.

Consultez Métadonnées sémantiques.