Integración con Claude
Visión general
La Integración de IA te permite conectar herramientas de IA como Claude 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 conectarte mediante el conector personalizado de Claude.
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
| Herramienta | Descripción | Alcance |
|---|---|---|
help |
Devuelve la guía de servicio de 3Min API por tema | Pública |
endpoints (list / get) |
Listar endpoints / ver detalles | Tu propio |
logs (lookup / search / fetch archived) |
Búsqueda de un registro, búsqueda de texto, fetch de payloads archivados | Tu propio |
stats |
Estadísticas mensuales / diarias de uso de API | Tu propio |
subscription |
Plan actual, uso e información de facturación | Tu cuenta |
archives (list / download) |
Lista de archivos archivados + URL de descarga temporal | Tu propio |
collaborators (list_keys / list_invitations) |
Lista de claves de colaboración e invitaciones | Tu propio |
Herramientas de creación / actualización / despliegue
| Herramienta | Descripción | Alcance |
|---|---|---|
endpoints (create) |
Crear un nuevo endpoint | Tu cuenta |
endpoints (update) |
Actualizar definiciones de campo, webhooks y notificaciones | Tu propio |
endpoints (deploy) |
Desplegar configuración de Sandbox a Producción | Tu propio |
collaborators (create_key) |
Crear una nueva clave de colaboración | Tu propio |
collaborators (update_permissions) |
Actualizar permisos CRUD de una clave de colaboración | Tu propio |
collaborators (invite) |
Enviar invitación de colaborador por email | Tu propio |
Herramientas de ejecución
| Herramienta | Descripción | Alcance |
|---|---|---|
api_call (GET / POST / PUT / DELETE) |
Envía una solicitud HTTP a tu endpoint desplegado (vía gateway) | Tu propio |
El
DELETEdeapi_callinvoca 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.
| Acción excluida | Dónde realizarla |
|---|---|
| Eliminar endpoint | Dashboard → APIs → Detalle del endpoint |
| Eliminar / desactivar clave de colaboración, regenerar API key | Dashboard → APIs → Detalle del endpoint → Claves de colaboración |
| Revocar invitación de colaborador | Dashboard → APIs → Detalle del endpoint → Colaboradores |
| Cambiar / cancelar plan | Dashboard → Configuración → Suscripción |
| Regenerar / eliminar clave API MCP | Dashboard → Configuración → Integración de IA → CLI / IDE |
| Eliminar archivo archivado | Dashboard → APIs → Archivos |
| Eliminar cuenta | Dashboard → Configuración → Perfil |
Cómo conectar
Claude usa el flujo OAuth. Solo registras una URL de servidor en el conector personalizado — el resto se resuelve iniciando sesión con tu cuenta de 3Min API. Sin clave API que introducir manualmente.
Paso 1 — Abre la configuración de Claude
Abre Claude en https://claude.ai y entra en Configuración desde el menú de cuenta de la esquina superior derecha.
Paso 2 — Ve a Conectores
En la barra lateral de configuración, elige la sección Conectores.
Paso 3 — Añade un conector personalizado
Haz clic en Añadir conector personalizado e introduce los campos:
Nombre del conector:
3minapi(cualquier nombre que prefieras)URL del servidor:
https://3minapi.com/api/mcp
Paso 4 — Conecta e inicia sesión vía OAuth
Cuando hagas clic en Conectar, se abrirá la página de inicio de sesión de 3Min API en una nueva ventana. Inicia sesión con tu cuenta habitual de 3Min API y los permisos se otorgan automáticamente.
Paso 5 — Úsalo en un nuevo chat
Abre un nuevo chat y empieza a usarlo.
El plan Free de Claude permite registrar 1 conector personalizado. Pro y superior es ilimitado.
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
He pulsado Conectar pero no aparece ninguna herramienta
La caché del conector de Claude a veces tarda un momento en refrescarse. Desconecta el conector y vuelve a conectarlo — la lista de herramientas debería aparecer correctamente en un nuevo chat.
Estoy en el plan Free y no puedo añadir un conector
Probablemente ya tienes un conector personalizado registrado. El plan Free está limitado a uno — elimina el conector existente o pasa a Pro o superior.
¿Y si los datos de otra persona se mezclan?
No pueden. Toda herramienta solo toca recursos de la cuenta autenticada por OAuth — 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.
¿Claude Code (terminal) se conecta de la misma forma?
No. Claude web / escritorio usa un conector personalizado basado en OAuth, mientras que Claude Code (CLI), Cursor y herramientas locales similares usan el flujo de clave API. Para esas, consulta la guía Integración MCP (CLI / IDE).