Cómo conectar Infisical a Cursor vía MCP

💡 ¿Sin instalación? Usa cloud.anythingmcp.com directamente. Inicia sesión, pulsa Connectors → Infisical, pega tus credenciales, genera una MCP API key y listo. Sin Docker, sin git clone, sin servidor local.

Infisical + Cursor

Gestión de secretos con Infisical en Cloud US, Cloud EU o autoalojado, con acceso como machine identity: proyectos, entornos, carpetas e importaciones de secretos, nombres y metadatos de los secretos, valores sueltos a petición, etiquetas, miembros de los proyectos, identidades y el registro de auditoría. Crea y actualiza secretos, carpetas, entornos y etiquetas; borrar un secreto está desactivado al instalar.

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:

INFISICAL_URL, INFISICAL_CLIENT_ID, INFISICAL_CLIENT_SECRET

Paso 1 — Obtener credenciales

La configuración lleva unos 5 minutos y necesita un administrador de la organización de Infisical. El conector accede como machine identity con Universal Auth.

1. En Infisical abre Organization, Access Control, Machine Identities (versiones anteriores: Organization Settings, Identities), pulsa Create Identity, llámala por ejemplo AnythingMCP y dale el rol de organización Member o un rol propio. Leer el registro de auditoría requiere un rol con acceso a él.
2. En la identidad añade el método de autenticación Universal Auth. Mantén la duración del access token (30 días por defecto) o acórtala; el conector vuelve a iniciar sesión por sí solo. En Client Secrets crea un secreto con usage limit 0 (ilimitado), porque cada nuevo inicio de sesión lo usa una vez. Si defines Trusted IPs, incluye la dirección de salida de tu servidor AnythingMCP.
3. Copia el Client ID (un UUID) en INFISICAL_CLIENT_ID y el Client Secret, que se muestra una sola vez, en INFISICAL_CLIENT_SECRET.
4. Añade la identidad a cada proyecto al que deba llegar: en el proyecto abre Access Control, Machine Identities, Add Identity, con el rol Viewer para solo lectura, o Developer o un rol propio para escribir. Limita el rol a los entornos y rutas que necesita.
5. Pon en INFISICAL_URL https://app.infisical.com (Cloud US), https://eu.infisical.com (Cloud EU) o la dirección de tu propia instancia, sin /api y sin barra final.
6. Instala el conector y ejecuta infisical_list_projects: confirma el inicio de sesión y lista los proyectos a los que pertenece la identidad.

El conector inicia sesión en /api/v1/auth/universal-auth/login, envía el access token como Authorization: Bearer y lo renueva solo.

Los valores de los secretos llegan a la IA: Infisical devuelve un valor en texto plano a quien tenga permiso para leerlo, y cada valor que este conector lee o escribe pasa por la conversación y por el proveedor de IA. Por eso infisical_list_secrets e infisical_get_secret devuelven solo nombres y metadatos: piden a Infisical que no envíe los valores. La única herramienta que devuelve un valor es infisical_read_secret_value, un secreto por llamada, y la IA la usa solo cuando pides justo ese valor. Los valores que pasas a infisical_create_secret e infisical_update_secret también pasan por la conversación. Si nunca debe aparecer un valor en el chat, un administrador del espacio de trabajo desactiva infisical_read_secret_value, o la identidad recibe un rol sin permiso para leer valores. Infisical registra cada lectura de un valor en su registro de auditoría.

Qué lee: la organización de la identidad (infisical_get_identity_details); los proyectos con sus entornos (nombre, slug, id); las carpetas de un entorno, como lista o con recursive como árbol completo; las importaciones de secretos, es decir, otros entornos o rutas de los que una carpeta hereda secretos; los nombres de los secretos con versión, comentario, etiquetas, metadatos y fechas, filtrados con tag_slugs o metadata_filter, y con infisical_get_secret los metadatos de un secreto o una version anterior; las etiquetas; los miembros de los proyectos con sus roles, las identidades de los proyectos y las de la organización; y el registro de auditoría de la organización (infisical_list_audit_logs), filtrado por proyecto, entorno, secreto, actor, tipo de evento como get-secret, update-secret o delete-secret y fechas, para saber quién leyó o cambió un secreto. infisical_read_secret_value resuelve referencias como ${DB_HOST} salvo que expand_secret_references sea false.

Qué escribe: infisical_create_secret, infisical_update_secret (nuevo valor, nuevo nombre con new_secret_name, comentario o etiquetas; tag_ids sustituye toda la lista de etiquetas), infisical_create_folder, infisical_create_environment e infisical_create_tag. Infisical conserva la versión anterior de un secreto, así que un cambio de valor se puede deshacer en el panel. Las aplicaciones que leen el secreto reciben el valor nuevo en su siguiente lectura, por eso la IA confirma contigo el entorno antes de escribir en producción. Si un entorno tiene una política de aprobación de cambios, crear o actualizar abre una solicitud de aprobación en Infisical en lugar de cambiar el secreto en el acto.

Desactivadas al instalar: infisical_delete_secret. No se puede deshacer desde este conector y rompe cada aplicación y pipeline que lee el secreto, así que un administrador del espacio de trabajo la activa cuando el equipo la necesita.

Formatos de datos: los id son UUID; los entornos se indican por slug (dev, staging, prod), los proyectos por id. Las rutas empiezan por /, y / sola es la raíz. version cuenta los cambios de un secreto; secretValueHidden: true significa que el valor no se envió. Las horas son ISO 8601 en UTC.

Paginación: infisical_list_audit_logs (20 entradas por defecto), infisical_list_project_identities e infisical_list_org_identities (100 por defecto) paginan con offset y limit; la IA vuelve a pedir con un offset mayor mientras una página llegue llena. Las demás listas lo devuelven todo en una respuesta.

Límites: por minuto e IP de cliente, Infisical Cloud permite, según el plan, de 200 a 600 lecturas, de 90 a 300 escrituras y de 120 a 500 operaciones con secretos, 600 peticiones en total. Un 429 indica cuántos segundos esperar. Cuánto tiempo se guarda el registro de auditoría depende del plan. Infisical autoalojado necesita la versión 0.150 o posterior para la API v4 de secretos que usa el conector.

Errores comunes: 401, o 403 con TokenError, significa que el inicio de sesión falló: Client ID o Client Secret incorrectos, un client secret revocado, caducado o agotado, la región equivocada en INFISICAL_URL o una IP fuera de las trusted IPs. 403 PermissionDenied significa que el rol de la identidad no permite ese proyecto, entorno, ruta o acción. 404 significa un id, slug, ruta o nombre de secreto incorrecto; los nombres distinguen mayúsculas y minúsculas.

Con las herramientas activas al instalar, el conector no borra secretos. Lee como mucho un valor por llamada, no cambia miembros, roles ni machine identities y no gestiona certificados ni claves KMS.

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 Cursor

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.

Cursor lee los servidores MCP de ~/.cursor/mcp.json. Añade esta entrada:

{
  "mcpServers": {
    "anythingmcp": {
      "url": "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 Cursor.
3. Abre Cursor → Settings → MCP y comprueba que anythingmcp aparece en la lista y está conectado.
4. Empieza a chatear: el agente ya puede usar las herramientas de Infisical.

Herramientas disponibles

Ejemplos de prompts

• "¿Qué secretos hay en el entorno prod de nuestro proyecto backend? Solo los nombres, sin valores."
• "¿Quién cambió el secreto STRIPE_SECRET_KEY en producción en los últimos 7 días?"
• "Muéstrame el valor de DATABASE_URL en el entorno staging del proyecto api."
• "Crea una carpeta /payments en dev y añade un secreto PAYMENTS_WEBHOOK_URL con el valor https://example.com/hooks/payments."
• "¿Qué machine identities y usuarios tienen acceso al proyecto web, y con qué roles?"

FAQ

¿Cursor admite servidores MCP personalizados en el plan gratuito? Sí, MCP está disponible en los planes Hobby, Pro y Business.

Siguientes pasos

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