Accéder à REZICS

Développeurs

Votre agent IA se connecte à /mcp.

REZICS propose un serveur MCP distant à l’adresse /mcp. Votre agent s’y connecte avec le jeton que vous avez autorisé. Les outils disponibles dépendent de ses droits actuels, et chacun correspond à une opération HTTP.

Relais

MCP relaie les appels, sans créer une autre voie d’écriture.

Chaque appel d’outil est relayé une seule fois vers l’opération HTTP correspondante, avec le même jeton et la même clé d’idempotence. Cette opération détermine l’identité, les autorisations et le quota utilisé.

Le texte des œuvres et des pages consulté par un outil est traité comme une donnée, jamais comme une instruction.

Une feuille bleu gris foncé percée d’une rangée de trous est traversée par une bande bleu clair qui passe alternativement dessus et dessous.

Connexion

Quatre étapes de connexion

  • Lire les métadonnées de la ressource

    GET /.well-known/oauth-protected-resource/mcp

    Une requête sans jeton reçoit une réponse 401. Son en-tête pointe vers ces métadonnées, qui indiquent le serveur d’autorisation et les permissions prises en charge.

  • Enregistrer le client et obtenir un jeton

    RFC 7591 · PKCE

    Le client de l’agent peut s’enregistrer, puis obtenir un jeton avec le code d’autorisation et PKCE. L’enregistrement ne donne aucun droit sur les ressources.

  • Lister les outils

    tools/list

    La liste n’inclut que les outils actuellement accessibles à cette identité.

  • Appeler un outil

    tools/call

    Le résultat reprend le code d’état HTTP, les en-têtes et le contenu. Les codes à partir de 400 sont signalés comme des erreurs.

Même opération

L’appel de l’agent est relayé vers la même opération HTTP.

  • Application

    GET /v1/search/catalogue
  ?q=voyage&limit=5

  • Agent

    {
  "name": "search_catalogue",
  "arguments": {
    "query": {
      "q": "voyage",
      "limit": 5
    }
  }
}
    Envoyez ces paramètres avec tools/call.

Même réponse

operationId
  getV1SearchCatalogue
profile
  public-catalogue-ranked-v1

Exemple de recherche de « voyage » dans le catalogue. L’agent reçoit la même réponse, accompagnée du code d’état et des en-têtes HTTP. Les paramètres sont regroupés selon l’opération HTTP : path, query, headers et body.

Outils

Liste des outils

Les outils sont générés à partir des capacités déclarées par l’API. Chaque déclaration indique le nom de l’outil, son rôle et les autorisations nécessaires. La génération échoue si un nom est dupliqué ou si l’opération correspondante n’existe pas.

Consulter le catalogue

  • search_catalogue

    Rechercher dans le catalogue par mots clés

    GET /v1/search/catalogue · work:read

  • read_resource

    Lire une ressource

    GET /v1/resources/{resource} · work:read context:read

  • resource_summaries

    Lire plusieurs résumés de ressources

    POST /v1/resources/summaries · work:read context:read

  • resource_relations

    Lire les liens d’une ressource

    GET /v1/resources/{resource}/relations · work:read

  • work_editions

    Lire les versions d’une œuvre

    GET /v1/works/{id}/releases · work:read

Bibliothèque

  • library_export

    Exporter toute la bibliothèque

    GET /v1/me/library-export · work:read rating:read

  • library_import_create

    Envoyer un fichier de bibliothèque

    POST /v1/me/library-imports · work:read library:write

  • library_import_rows

    Examiner les correspondances ligne par ligne

    GET /v1/me/library-imports/{id}/rows · work:read

  • library_import_resolve

    Choisir une œuvre pour une ligne

    PUT /v1/me/library-imports/{id}/rows/{row} · work:read library:write

  • library_import_adopt

    Ajouter une œuvre candidate absente du catalogue

    POST /v1/me/library-imports/{id}/rows/{row}/adoptions · work:read library:write work:create

  • library_import_apply

    Appliquer un import vérifié

    POST /v1/me/library-imports/{id}/apply · work:read library:write collection:edit rating:read rating:submit

  • library_import_status

    Consulter la progression de l’import

    GET /v1/me/library-imports/{id}/apply · work:read

  • library_import_delete

    Supprimer le fichier envoyé

    DELETE /v1/me/library-imports/{id} · work:read library:write

Wiki

  • wiki_candidates

    Comparer les noms extraits

    POST /v1/wiki/candidates · wiki:propose

  • wiki_validate

    Valider un résultat d’extraction

    POST /v1/wiki/validations · wiki:propose

  • wiki_history

    Lire le contenu Wiki accepté

    GET /v1/wiki/{work}/history · work:read

  • wiki_evidence

    Lire la source et la citation d’une affirmation

    GET /v1/wiki/evidence/{id} · work:read

Limites

Limites de chaque appel

  • 30 secondes

    Délai maximal pour chaque appel d’outil.

  • 1 MiB

    Taille maximale des requêtes d’outils ordinaires. Les fichiers de bibliothèque envoyés sont comptés séparément.

  • Sans état

    Chaque requête vérifie son jeton séparément. Le serveur ne conserve pas de session.

Développeurs

Autres pages

Créez vos propres outils avec la même API.

Permettez à vos applications de lire et modifier les œuvres, les bibliothèques et les données des communautés. Chaque opération suit les règles d’identité et d’autorisation de REZICS.

Accéder à REZICS

Produits

Modules

Langue