Ir a REZICS

Desarrolladores

Conecta tu agente de IA por /mcp.

REZICS ofrece un servidor MCP remoto en /mcp. Tu agente se conecta con un token autorizado por ti y ve las herramientas permitidas por sus permisos actuales. Cada herramienta corresponde a una operación HTTP.

Adaptador

MCP solo adapta las llamadas, no crea otra vía de escritura.

Cada llamada a una herramienta se reenvía una sola vez a la operación HTTP correspondiente, con el mismo token y la misma clave de idempotencia. Esa operación determina quién actúa, qué puede hacer y cuántas solicitudes consume.

El contenido de las obras y el texto de las páginas que leen las herramientas siempre se tratan como datos, nunca como instrucciones.

Una tira celeste pasa en zigzag por una fila de orificios en una hoja azul grisácea.

Conexión

Cuatro pasos para conectarte

  • Consulta los metadatos del recurso

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

    Una petición sin token recibe una respuesta 401 con una cabecera que apunta a estos metadatos, donde aparecen el servidor de autorización y los permisos disponibles.

  • Registra un cliente y obtén un token

    RFC 7591 · PKCE

    El cliente del agente puede registrarse y usar el código de autorización con PKCE para obtener un token. El registro por sí solo no concede acceso a ningún recurso.

  • Consulta las herramientas

    tools/list

    La lista solo incluye las herramientas disponibles para esta identidad.

  • Llama a una herramienta

    tools/call

    El resultado conserva el código de estado HTTP, las cabeceras y el contenido. Los códigos 400 o superiores se marcan como errores.

La misma operación

Las llamadas del agente se reenvían a la misma operación HTTP.

  • Programa

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

  • Agente

    {
  "name": "search_catalogue",
  "arguments": {
    "query": {
      "q": "viaje",
      "limit": 5
    }
  }
}
    Envía estos parámetros con tools/call.

La misma respuesta

operationId
  getV1SearchCatalogue
profile
  public-catalogue-ranked-v1

Ejemplo: busca «viaje» en el catálogo. El agente recibe la misma respuesta, con el código de estado HTTP y las cabeceras añadidos. Los parámetros se agrupan como path, query, headers y body, según la operación HTTP.

Herramientas

Lista de herramientas

Las herramientas se generan a partir de las capacidades declaradas por la API. La declaración indica el nombre, la función y los permisos necesarios. La generación falla si se repite un nombre o no existe la operación correspondiente.

Consulta el catálogo

  • search_catalogue

    Busca en el catálogo por palabras clave

    GET /v1/search/catalogue · work:read

  • read_resource

    Consulta un recurso

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

  • resource_summaries

    Consulta el resumen de varios recursos

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

  • resource_relations

    Consulta las relaciones de un recurso

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

  • work_editions

    Consulta las ediciones de una obra

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

Biblioteca

  • library_export

    Exporta toda tu biblioteca

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

  • library_import_create

    Sube un archivo de biblioteca

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

  • library_import_rows

    Revisa los resultados de comparación fila por fila

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

  • library_import_resolve

    Elige una obra para una fila

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

  • library_import_adopt

    Acepta una obra candidata que no está en el catálogo

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

  • library_import_apply

    Aplica una importación revisada

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

  • library_import_status

    Consulta el progreso de importación

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

  • library_import_delete

    Elimina el archivo subido

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

Wiki

  • wiki_candidates

    Compara los nombres extraídos

    POST /v1/wiki/candidates · wiki:propose

  • wiki_validate

    Valida una extracción antes de enviarla

    POST /v1/wiki/validations · wiki:propose

  • wiki_history

    Consulta el contenido aceptado de Wiki

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

  • wiki_evidence

    Consulta las fuentes y citas de una afirmación

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

Límites

Límites de cada llamada

  • 30 segundos

    Tiempo máximo para cada llamada a una herramienta.

  • 1 MiB

    Tamaño máximo de una petición habitual. Los archivos de la biblioteca se cuentan aparte.

  • Sin estado

    Cada petición valida su propio token y el servidor no guarda sesiones.

Desarrolladores

Otras páginas

Crea tus propias herramientas con la misma API.

Permite que tus programas lean y modifiquen obras, tu biblioteca y los datos de la comunidad. Cada operación aplica las reglas de identidad y autorización de REZICS.

Ir a REZICS

Productos

Módulos

Idioma