cicora.ai
Spécification de l’APIOutils, ressources, prompts

MCP

Connectez un client d’IA aux outils, ressources et prompts autorisés au moyen d’une URL de connexion émise dans les réglages du compte.

Référence d’intégration : choisissez les paramètres et les capacités disponibles dans les réglages de l’API de votre compte et dans le catalogue de modèles de votre environnement.

Configurer une connexion

Un client MCP reçoit une URL de connexion et une clé depuis une configuration sécurisée. N’ajoutez pas manuellement une route supposée : utilisez la valeur créée pour votre organisation.

Un serveur présente des outils, des ressources et des prompts. Le client doit indiquer à l’utilisateur quelle action est demandée et quel contexte sera lu.

Configuration du client MCP
typescript
const connection = {
  url: process.env.CICORA_MCP_URL,
  headers: { Authorization: "Bearer " + process.env.CICORA_API_KEY },
};

// Use the connection URL issued in account API settings.

Autorisations et exécution

  • Séparez la lecture, l’écriture et l’exécution au niveau de l’outil.
  • Validez les paramètres de l’action du côté de l’intégration avant l’exécution.
  • Conservez un journal de l’appel, de l’exécuteur et du résultat, sans secrets.

Connecter dans un produit

Isolez chaque connexion par organisation et par utilisateur afin qu’une clé ne puisse pas accéder à un autre contexte.

Vérifiez les outils disponibles lors de la connexion, puis à nouveau après toute modification d’autorisation, au lieu de les mettre indéfiniment en cache.