Conectar OpenAlex MCP con Gemini CLI

💡 ¿Sin instalación? Usa cloud.anythingmcp.com directamente. Inicia sesión, pulsa Connectors → OpenAlex, instálalo sin clave, genera una MCP API key y listo. Sin Docker, sin git clone, sin servidor local.

OpenAlex + Gemini

El catálogo abierto de la investigación OpenAlex, sin clave: busca y filtra unos 324 millones de publicaciones científicas con sus autores, instituciones, revistas, temas, editoriales y financiadores, sigue las citas, comprueba el estado de acceso abierto y cuenta registros agrupados por cualquier campo. Solo lectura; una clave gratuita multiplica por diez el presupuesto diario.

Requisitos previos

Las instrucciones de configuración completas están incluidas en el conector (visibles en el store al seleccionarlo). Las variables de entorno requeridas:

(ninguna obligatoria; opcional, recomendada: OPENALEX_API_KEY)

Paso 1 — Configurar el conector

Funciona sin clave: la configuración lleva un minuto. El conector lee OpenAlex (https://api.openalex.org), el catálogo abierto del sistema mundial de investigación que gestiona la organización sin ánimo de lucro OurResearch. Sus datos son CC0.

1. En la tienda de conectores, elige OpenAlex e instálalo. No hay paso Authorize with Provider.
2. Recomendado: las llamadas sin clave comparten un presupuesto de 0,10 USD al día por dirección de red, así que en un servidor compartido se agota pronto. Crea una cuenta gratuita en https://openalex.org/signup, copia la clave de Settings > API key (https://openalex.org/settings/api-key) y pégala en OPENALEX_API_KEY. Se envía como Authorization: Bearer y da 1 USD de uso gratuito cada día (diez veces el presupuesto sin clave), 30 peticiones por segundo y paginación con cursor.
3. Compruébalo con openalex_search_topics: lista temas de investigación con su jerarquía.

El antiguo polite pool con mailto= se sustituyó por claves de API en febrero de 2026; el parámetro se ignora.

Lo que cuesta una llamada: los registros individuales (openalex_get_*) son gratuitos, una lista filtrada o un recuento por grupos cuesta 0,0001 USD y una búsqueda de texto 0,001 USD. Cada respuesta de lista indica su coste en meta.cost_usd.

ID: los ID de OpenAlex son una letra y dígitos: W (obra), A (autor), S (fuente), I (institución), T (tema), P (editorial), F (financiador). La forma corta W2741809807 funciona en todas partes, igual que https://openalex.org/W2741809807. Las herramientas get aceptan también ID externos: doi:10.7717/peerj.4375, orcid:0000-0003-1613-5981, ror:042nb2s44, issn:0028-0836, pmid:29456894. La IA nunca filtra por nombre: primero convierte el nombre en un ID con openalex_autocomplete (lo más rápido, gratis) o con la herramienta de búsqueda correspondiente, y luego filtra por ese ID.

Qué lee:

• Obras (artículos, libros, conjuntos de datos, preprints, tesis): búsqueda con search (palabras clave, AND, OR, NOT, "frases"), search_exact (sin stemming) o search_semantic (un párrafo, por significado, máximo 50 resultados), combinada con filter y sort, por ejemplo cited_by_count:desc.
• Obras de un autor, una institución, una revista, un tema o un financiador con filtros como authorships.author.id:A..., authorships.institutions.id:I..., primary_location.source.id:S..., topics.id:T... o funders.id:F..., además de publication_year:2020-2025, type:article o is_oa:true. Hasta 100 DOI a la vez con doi:10.1/a|10.2/b.
• Una obra completa: resumen, autores con instituciones, fuente, temas, palabras clave, financiadores y ayudas, ubicaciones en acceso abierto, referencias, obras relacionadas y citas por año. Quién la cita: una búsqueda de obras con cites:W....
• Autores (con ORCID, afiliaciones a lo largo del tiempo, índice h e índice i10), fuentes (revistas, repositorios, congresos con ISSN, estado de acceso abierto y DOAJ, precio APC), instituciones (con ROR, entidades superiores e inferiores), los unos 4.500 temas (domain > field > subfield > topic), editoriales y financiadores, cada uno como búsqueda y como registro individual.
• Recuentos con openalex_group_by: obras por año, por estado de acceso abierto, por institución, por país o por tema, hasta 200 grupos, en una sola llamada barata en lugar de recorrer páginas.

Formatos de datos: las herramientas de lista devuelven un registro ligero por resultado (ID, nombres, recuentos, acceso abierto y nombres de autores); el resto lo da la herramienta get correspondiente, y select deja solo los campos de primer nivel que nombres. cited_by_count cuenta las obras que citan; fwci es el impacto de citas normalizado por campo (1,0 es la media mundial). oa_status es diamond, gold, green, hybrid, bronze o closed. El resumen llega como abstract_inverted_index (cada palabra con sus posiciones), que la IA vuelve a convertir en texto. Las fechas son YYYY-MM-DD.

Paginación: per_page hasta 100 y page llegan a los primeros 10.000 resultados; meta.count es el total. Más allá, la IA usa cursor (primero *, luego meta.next_cursor), que a partir de la segunda página necesita una clave de API.

Solo lectura: todas las herramientas solo leen, así que no hay nada que confirmar y ninguna herramienta queda desactivada al instalar.

Límites: 429 significa que el presupuesto diario se ha agotado (sin clave lo comparten todos los que usan la misma dirección) o que llegaron más de 10 peticiones por segundo (30 con clave); la búsqueda semántica admite 1 por segundo. Los presupuestos se reinician a medianoche UTC.

Errores frecuentes: 403 key_not_activated significa que la dirección de correo de la clave aún no está confirmada: abre el enlace de activación que envió OpenAlex. 401 indica una clave incorrecta. 400 señala un filtro o campo no válido, 404 un ID desconocido.

El conector no descarga PDF (0,01 USD cada uno) ni gestiona colecciones, búsquedas guardadas, alertas o correcciones de perfiles de autor.

Paso 2 — Instalar el adapter

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ñadir 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 OpenAlex.

Herramientas disponibles

Ejemplos de prompts

• "¿Cuántas obras ha publicado la ETH de Zúrich cada año desde 2015 y qué parte es de acceso abierto?"
• "Encuentra los 20 artículos más citados sobre células solares de perovskita desde 2020, con DOI y revista."
• "¿Qué instituciones publican más sobre edición genética con CRISPR y en qué países están?"
• "Muéstrame el índice h, el ORCID y los temas principales de esta autora, y lista las obras que citan su artículo más citado."
• "¿Qué financiadores aparecen con más frecuencia en los artículos de machine learning en medicina publicados en 2024?"

FAQ

¿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.

Siguientes pasos

• Página del conector
• Conectar a Claude
• Conectar a ChatGPT
• Conectar a Cursor
• Conectar a Meta Muse
• Conectar a Microsoft Copilot