Integración MCP (CLI / IDE)

Visión general

La Integración de IA te permite conectar herramientas de IA como Claude Code y Cursor a 3Min API y operar tus endpoints en el mismo tipo de chat informal que ya usas. Por debajo habla MCP (Model Context Protocol), un estándar abierto. Una vez la IA queda conectada al servidor de 3Min API, elige la herramienta adecuada de las que exponemos y te responde.

El beneficio es concreto. Sin código puedes crear un nuevo endpoint, buscar los registros de llamadas de ayer, invitar a un colaborador o revisar el uso del mes. Sin tener que hacer clic en el dashboard — basta con "Resume las 5 llamadas fallidas de la semana pasada".

3Min API admite dos métodos de autenticación. ChatGPT y Claude usan OAuth (inicia sesión con tu cuenta de 3Min API), por lo que no hay clave API que administrar. Las herramientas CLI/IDE como Claude Code o Cursor usan claves API que guardas en tu configuración local. Esta página te guía para conectar herramientas locales con el flujo de clave API.

Por dónde empezar

• Dashboard → Configuración → Integración de IA → pestaña CLI / IDE

Lo que puedes hacer

El servidor MCP de 3Min API expone las herramientas de abajo. La IA observa tu solicitud y elige la adecuada. Toda acción está acotada a tu propia cuenta — los recursos de otros usuarios nunca son accesibles.

Herramientas de lectura

Herramientas de creación / actualización / despliegue

Herramientas de ejecución

El DELETE de api_call invoca la lógica de negocio de tu propio endpoint (p. ej., un API de "cancelar pedido"). No elimina el endpoint en sí.

Seguridad: acciones intencionalmente no expuestas a la IA

Las acciones siguientes están deliberadamente excluidas de MCP. No queremos que un error de IA o una llamada accidental borre datos o dispare cargos sorpresa. Cuando necesites hacerlas, inicia sesión directamente en https://3minapi.com.

Cómo conectar

Las herramientas CLI/IDE usan el flujo de clave API. Pega la clave MCP de 3Min API una sola vez en tu archivo de configuración local y, a partir de ahí, esa herramienta queda autenticada en tu nombre. La clave completa se muestra solo una vez al emitirla, así que cópiala de inmediato.

Paso 1 — Abre la pestaña CLI / IDE

Desde el dashboard, abre el menú de cuenta (esquina superior derecha) → Configuración → Integración de IA → pestaña CLI / IDE.

Paso 2 — Genera una clave API MCP

Haz clic en Generar clave API MCP. Se mostrará una sola vez una clave con el prefijo tm_mcp_.

No podrás volver a ver la clave completa después de salir de esta pantalla. Cópiala de inmediato con el botón de copiar y guárdala en un lugar seguro. Si la pierdes, deberás generar una nueva — y la antigua se invalida al instante.

Paso 3 — Copia el fragmento de configuración

La tarjeta Configuración en la parte inferior de la página muestra un JSON precompletado con tu clave. Cópialo tal cual.

{
	"mcpServers": {
		"3minapi": {
			"type": "http",
			"url": "https://3minapi.com/api/mcp",
			"headers": { "x-api-key": "tm_mcp_..." }
		}
	}
}

Paso 4 — Pega en el archivo de configuración MCP de tu herramienta

Añade el fragmento al archivo de configuración MCP de la herramienta que uses. La ubicación exacta varía — consulta la documentación de cada herramienta:

• Claude Code: .mcp.json en la raíz del proyecto o configuración de usuario
• Cursor: Configuración → MCP Servers
• Otras herramientas compatibles con MCP aceptan el mismo formato JSON

Guarda la configuración y reinicia la herramienta — debería detectar las herramientas de 3minapi.

Paso 5 — Gestiona la clave

Más tarde puedes regenerar o eliminar la clave desde la misma pantalla:

• Regenerar clave — emite una nueva clave e invalida la antigua de inmediato. Úsalo si la has perdido o sospechas filtración. Tras regenerar, sustituye el valor nuevo en el archivo de configuración de cada herramienta.
• Eliminar clave — elimina la clave por completo. Después de eliminarla, ninguna herramienta puede acceder a tu cuenta en tu nombre.

Ejemplos de prompts

Estos prompts en lenguaje natural funcionan bien:

• "Muéstrame mi lista de endpoints API."
• "Crea un endpoint para consultas de clientes con campos nombre, email y mensaje."
• "Resume las 5 llamadas fallidas de ayer."
• "¿Cuánto he usado este mes hasta ayer?"
• "Invita a chris@example.com como colaborador en el endpoint user-signup."

Para solicitudes que crean, actualizan o despliegan algo, la IA confirma contigo antes de avanzar. Lee la respuesta con cuidado para que no se cuelen cambios no deseados.

Tropiezos comunes

• Cerré la pantalla sin copiar la clave API completa

  Por seguridad, la clave completa solo aparece una vez al emitirla. Que no puedas volver a verla es por diseño. Haz clic en Regenerar clave desde la pestaña CLI / IDE para generar una nueva (la antigua se invalida al instante, así que actualiza la configuración en cada herramienta que uses).

• Pegué la clave pero la herramienta no la reconoce

  Reinicia la herramienta por completo — guardar la configuración por sí sola puede no reconectar el servidor MCP. Un error tipográfico en el JSON también puede ser ignorado en silencio, así que verifica el formato.

• ¿Y si los datos de otra persona se mezclan?

  No pueden. La clave API MCP está vinculada a la cuenta que la emitió, así que toda herramienta solo toca tus propios recursos — los endpoints, registros y archivos de otros usuarios nunca se ven.

• ¡La IA borró mi endpoint!

  No puede. Las acciones destructivas están excluidas de MCP, así que por más que la IA lo intente, tus datos siguen ahí. Para borrar de verdad, inicia sesión en https://3minapi.com.

• ¿En qué se diferencia de tm_test_* y tm_live_*?

  Son claves completamente distintas. tm_test_* (Sandbox) y tm_live_* (Producción) son claves de colaboración que usan los llamadores externos para invocar tus endpoints API. tm_mcp_* la usan las herramientas de IA para acceder a tu cuenta de 3Min API. Mezclarlas provoca fallos de autenticación.