Conectar Strapi con Gemini CLI vía MCP

💡 ¿Sin instalar nada? Usa directamente cloud.anythingmcp.com. Inicia sesión, haz clic en Connectors → Strapi 5, pega tus credenciales, genera una clave de API de MCP y listo. Sin Docker, sin git clone, sin servidor local.

Strapi 5 + Gemini

Conéctate a una instancia de Strapi 5 para comprobar su disponibilidad, consultar documentos de tipos de colección y recuperar documentos individuales a través de la API REST de contenido de solo lectura.

Requisitos previos

Consulta las instrucciones de configuración completas incluidas en el conector (visibles en la tienda dentro de la aplicación cuando seleccionas el conector). Las variables de entorno necesarias para este conector son:

STRAPI_URL, STRAPI_API_TOKEN

Paso 1 — Obtén las credenciales

La configuración lleva unos 2 minutos. Necesitas una instancia de Strapi 5 y un token de la API de contenido de solo lectura.

1. Asigna a STRAPI_URL la URL raíz de tu instancia de Strapi, por ejemplo https://cms.example.com, sin /api al final.
2. En el panel de administración de Strapi, abre Settings → API Tokens y crea un token de la API de contenido con acceso de solo lectura a los tipos de colección que la IA deba ver. Cópialo en STRAPI_API_TOKEN. Solo se envía en la cabecera Authorization Bearer.
3. Instala el conector y ejecuta strapi_health para comprobar que Strapi es accesible. Después ejecuta strapi_list_documents sobre una colección que conozcas, como articles: solo así verás que el token funciona, porque strapi_health no comprueba el token ni sus permisos.

Dónde se ejecuta Strapi: Strapi Cloud y cualquier otra instancia de Strapi 5 accesible públicamente funcionan desde AnythingMCP Cloud. Una instancia en una red privada, en localhost o en una dirección IP privada solo funciona con AnythingMCP autoalojado, y su host debe estar permitido mediante SSRF_ALLOWED_HOSTS, porque la protección de salida bloquea por defecto el espacio de direcciones privadas.

Qué lee: documentos de un tipo de colección cada vez. Un tipo de colección se indica con su ID de API en plural, como articles, no con su nombre visible, y el conector no puede descubrir los tipos de colección por ti. strapi_list_documents admite selección de campos, operadores de filtro de Strapi, ordenación (field:asc o field:desc), paginación por páginas, populate para relaciones o contenido multimedia, locale para contenido localizado y status para documentos publicados o en borrador; conserva el meta de Strapi, de modo que la información de paginación sigue disponible. strapi_get_document obtiene un documento por su documentId de Strapi 5. Las relaciones, el contenido multimedia, los componentes y las zonas dinámicas solo se devuelven cuando populate los solicita.

Solo lectura: las tres herramientas son peticiones GET. El conector no puede crear, actualizar, publicar, despublicar ni eliminar contenido.

El conector funciona únicamente con la API REST de contenido de Strapi 5: no admite los formatos de respuesta de Strapi 4 ni las API de Admin, Content Manager y Content-Type Builder.

Paso 2 — Instala el adaptador

curl -fsSL https://raw.githubusercontent.com/HelpCode-ai/anythingmcp/main/docker-compose.quickstart.yml -o docker-compose.yml
printf 'JWT_SECRET=%s\nENCRYPTION_KEY=%s\n' "$(openssl rand -hex 32)" "$(openssl rand -hex 32)" > .env
docker compose up -d

Paso 3 — Añade el conector en Gemini

La URL de tu servidor: en AnythingMCP abre MCP Servers → el servidor donde está este conector y copia su URL (https://cloud.anythingmcp.com/mcp/…). Úsala donde esta guía muestra YOUR_SERVER_ID.

Gemini CLI lee los servidores MCP de ~/.gemini/settings.json (en Windows, %USERPROFILE%\.gemini\settings.json). Añade:

{
  "mcpServers": {
    "anythingmcp": {
      "httpUrl": "https://cloud.anythingmcp.com/mcp/YOUR_SERVER_ID",
      "headers": { "X-API-Key": "YOUR_MCP_API_KEY" }
    }
  }
}

1. Crea una clave de API MCP en AnythingMCP en MCP Servers → tu servidor → API keys y pégala en lugar de YOUR_MCP_API_KEY.
2. Guarda el archivo y reinicia gemini.
3. Ejecuta /mcp dentro de Gemini CLI (o gemini mcp list en tu terminal): anythingmcp debería aparecer como conectado.
4. Empieza a escribir prompts: Gemini CLI ya puede llamar a las herramientas de Strapi 5.

Herramientas disponibles

Preguntas frecuentes

¿Dónde busca Gemini CLI los servidores MCP? En ~/.gemini/settings.json para tu usuario, o en .gemini/settings.json dentro de un proyecto. gemini mcp list muestra cada servidor y si se conecta.

Próximos pasos

• Página del conector
• Conectar con Claude
• Conectar con ChatGPT