3Min API

3Min API — Guía del Servidor MCP

Documentación técnica del servidor MCP de 3Min API. Esta guía cubre las herramientas disponibles, autenticación, instrucciones de configuración y ejemplos de uso.

1. Descripción del Servidor

3Min API es un servicio de retransmisión de API diseñado para pequeñas empresas sin capacidad de desarrollo backend. Utiliza un diseño Schema-as-Data donde los esquemas de API se almacenan como datos estructurados, eliminando la necesidad de configuración de base de datos por cliente.

El servidor MCP permite que asistentes de IA como Claude gestionen endpoints de API, envíen solicitudes de prueba, busquen registros, vean análisis y gestionen colaboradores — todo a través de conversación en lenguaje natural.

2. Características

Herramientas Disponibles

  • help — Obtener ayuda guiada y referencia del servicio para cualquier tema
  • endpoints — Crear, configurar, actualizar y desplegar endpoints de API
  • api_call — Enviar solicitudes HTTP (POST, GET, PUT, DELETE) a través del API Gateway
  • logs — Buscar registros por texto, rango de fechas o ID de registro con soporte de payload archivado
  • stats — Ver análisis de uso mensual con desgloses diarios por endpoint
  • collaborators — Gestionar claves de colaboración, permisos e invitaciones
  • subscription — Consultar detalles del plan, conteo de uso e información de facturación
  • archives — Listar y descargar archivos de datos archivados (solo CLI)

Casos de Uso

  • Configurar y probar endpoints de API rápidamente sin escribir código
  • Monitorear el uso de API e investigar problemas a través de registros y estadísticas
  • Gestionar acceso del equipo creando claves de colaboración y enviando invitaciones

3. Instrucciones de Configuración

URL del Servidor MCP:

https://3minapi.com/api/mcp

Claude.ai / Claude Desktop

  1. Abrir Configuración → Conectores
  2. Haga clic en "Agregar Conector Personalizado"
  3. Ingrese la URL del servidor MCP mostrada arriba
  4. Complete el inicio de sesión OAuth cuando se le solicite

No se necesita clave API — la autenticación se gestiona automáticamente a través de OAuth.

Claude Code / CLI

  1. Genere una clave API MCP desde su panel (Configuración → Integración MCP)
  2. Agregue la configuración del servidor a su cliente MCP:
{
  "mcpServers": {
    "3minapi": {
      "url": "https://3minapi.com/api/mcp",
      "headers": {
        "x-api-key": "YOUR_MCP_API_KEY"
      }
    }
  }
}

Reemplace YOUR_MCP_API_KEY con la clave generada en el paso 1.

4. Autenticación

El servidor MCP soporta OAuth 2.1 con PKCE (S256) para clientes basados en navegador y autenticación por clave API para herramientas CLI.

OAuth 2.1 (Claude.ai / Desktop)

Completamente automatizado — los usuarios simplemente inician sesión a través de su navegador. El servidor implementa:

  • RFC 8414 — Authorization Server Metadata Discovery
  • RFC 7591 — Dynamic Client Registration
  • RFC 9728 — Protected Resource Metadata
  • PKCE (S256) — Proof Key for Code Exchange

Clave API (CLI)

Pase la clave API MCP a través del encabezado x-api-key o como variable de entorno en la configuración de su cliente MCP.

5. Ejemplos de Uso

Ejemplo 1: Crear un Endpoint API en Sandbox

"Usando 3minapi, quiero recibir pedidos en línea. Necesito el nombre del cliente, el monto del pedido y la dirección de correo electrónico. El nombre y el correo deben ser buscables."

Action: Claude llama a endpoints(action: "create", endpoint_name: "orders", field_definitions: [...])

Result: Se crea un nuevo endpoint con definiciones de campo en sandbox. La respuesta incluye el ID del endpoint, una clave de colaboración predeterminada con claves API de sandbox/producción, y la URL del endpoint para recibir llamadas API.

Ejemplo 2: Probar con una Llamada API en Sandbox

"Envía un pedido de prueba de John Doe por $150 al endpoint que acabo de crear"

Action: Claude llama a api_call(endpoint_id: "...", environment: "sandbox", method: "POST", body: [fields]), luego logs(endpoint_id: "...", environment: "sandbox") para verificar el resultado.

Result: El API Gateway procesa la solicitud de forma asíncrona (202 Accepted). Claude luego recupera la entrada de registro mostrando que el registro fue creado exitosamente con todos los valores de campo almacenados.

Ejemplo 3: Buscar Registros en Sandbox

"Muéstrame todos los pedidos de la última semana que mencionen a John"

Action: Claude llama a logs(endpoint_id: "...", environment: "sandbox", search_text: "john", start_date: "...", end_date: "...")

Result: Devuelve las entradas de registro coincidentes con IDs de registro, métodos HTTP, códigos de estado, marcas de tiempo y datos de payload. Los resultados están paginados (10 por página) con conteo total.

6. Política de Privacidad

Nuestra política de privacidad completa está disponible en:

https://3minapi.com/es/privacy

7. Soporte

Para preguntas, problemas o comentarios:

Correo: contact@3minapi.com