Servidor MCP de Melora Connect para asistentes de IA

Qué es

El servidor MCP da a un asistente una herramienta por cada operación de la API REST, salvo las suscripciones de webhooks. Cada herramienta hace los mismos controles, usa el mismo permiso y los mismos límites, y da la misma respuesta que su endpoint.

Para esto no corre ninguna IA dentro de Melora Connect: el asistente corre donde usted lo usa y llama a Melora Connect con la clave de API de su organización. Los cambios que hace quedan en el registro de auditoría de la organización con el nombre de la clave, igual que los cambios hechos por la API.

Dirección del servidor

La dirección del servidor es:

https://app.meloraconnect.com/api/public/mcp

Cada solicitud lleva una clave de API en el encabezado Authorization, después de la palabra Bearer, igual que en la API REST.
El transporte es HTTP transmisible de MCP, sin estado: un mensaje JSON-RPC 2.0 por solicitud POST, respondido con JSON. No hay flujo de eventos ni sesión, así que GET y DELETE responden 405.
Versiones del protocolo: 2025-11-25, 2025-06-18, 2025-03-26, 2024-11-05. El servidor responde con la versión que pide el cliente cuando la admite y, si no, con la más reciente.
Una solicitud enviada desde una página web de otro sitio (con otro encabezado Origin) se rechaza con 403.

Crear una clave

En Melora Connect, abra Settings y luego la pestaña API keys. Necesita permiso para administrar la configuración de la organización.
Cree una clave solo para el asistente, con su nombre, con únicamente los permisos que quiere que use y con una fecha de vencimiento.
Copie la clave. Se muestra una sola vez. Póngala en la configuración del asistente, nunca en un mensaje de chat.

El asistente solo ve las herramientas que su clave permite. Una clave que solo puede leer no puede cambiar nada, se le pida lo que se le pida al asistente.

Conectar un cliente

Defina la variable de entorno MELORA_API_KEY con su clave, o ponga su clave donde los ejemplos dicen melora_YOUR_KEY.

Claude Code

Agregue el servidor desde una terminal:

claude mcp add --transport http melora https://app.meloraconnect.com/api/public/mcp \
  --header "Authorization: Bearer $MELORA_API_KEY"

Claude Desktop

Claude Desktop llega a un servidor que usa una clave a través del puente de código abierto mcp-remote, que necesita Node.js. Agregue esto a su archivo de configuración (Settings, Developer, Edit config) y reinicie Claude Desktop:

{
  "mcpServers": {
    "melora": {
      "command": "npx",
      "args": [
        "-y",
        "mcp-remote",
        "https://app.meloraconnect.com/api/public/mcp",
        "--header",
        "Authorization:${MELORA_AUTH}"
      ],
      "env": {
        "MELORA_AUTH": "Bearer melora_YOUR_KEY"
      }
    }
  }
}

API de OpenAI

La Responses API llama al servidor por sí misma con su herramienta MCP. Deje require_approval activado, para que cada llamada se le muestre antes.

curl https://api.openai.com/v1/responses \
  -H "Authorization: Bearer $OPENAI_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "model": "YOUR_MODEL",
    "tools": [{
      "type": "mcp",
      "server_label": "melora",
      "server_url": "https://app.meloraconnect.com/api/public/mcp",
      "headers": { "Authorization": "Bearer melora_YOUR_KEY" },
      "require_approval": "always"
    }],
    "input": "List our lapsed members."
  }'

Claude.ai y ChatGPT

Sus conectores web y de aplicación inician sesión con OAuth, y el servidor MCP de Melora Connect usa en cambio una clave de API. Conéctese mediante Claude Code, Claude Desktop o la API de OpenAI.

Otros clientes MCP

Cualquier cliente que se conecte a un servidor remoto por HTTP transmisible y pueda enviar un encabezado Authorization puede usar el servidor, con la dirección y el encabezado de arriba.

Herramientas

Las herramientas, el permiso que necesita cada una, el endpoint REST al que equivale y qué devuelve:

Herramienta	Permiso requerido	Equivale a	Qué devuelve
`list_members`	`members.read`	`GET /members`	Una página de miembros: `data`, `page`, `per_page` y `has_more`.
`get_member`	`members.read`	`GET /members/{id}`	Un miembro, en `data`.
`create_member`	`members.write`	`POST /members`	El miembro nuevo en `data`, y `welcome_drips` cuando se pide.
`update_member`	`members.write`	`PATCH /members/{id}`	El miembro cambiado, en `data`.
`unsubscribe_member`	`members.write`	`POST /members/{id}/email-preferences`	La baja del miembro (`member_id`, `email_marketing_opt_out`, `email_marketing_opted_out_at`), en `data`.
`list_events`	`events.read`	`GET /events`	Una página de eventos.
`get_event`	`events.read`	`GET /events/{id}`	Un evento con sus inscripciones, en `data`.
`create_event`	`events.manage`	`POST /events`	El evento nuevo en borrador, en `data`.
`list_dues_invoices`	`members.billing.read`	`GET /dues-invoices`	Una página de facturas de cuotas.

Una herramienta recibe los mismos campos que su endpoint: los filtros, page y per_page de una lista, el id de un registro, y el cuerpo de una creación o de un cambio (update_member recibe el id junto con los campos que cambian). Ninguna herramienta recibe una organización: siempre es la de la clave, y una herramienta rechaza cualquier campo que no conoce. Los resultados vuelven como texto JSON y como contenido estructurado.

Las herramientas de lectura están marcadas como de solo lectura. Las que agregan o cambian algo están marcadas como cambios, así que los clientes preguntan antes de ejecutarlas: siga aprobando cada una de esas llamadas, y en Claude Code y Claude Desktop no permita que se ejecuten sin preguntarle. create_member puede iniciar los correos de bienvenida de la organización cuando se le pide.

Lo que devuelven las herramientas (nombres, biografías, empresas, campos personalizados, descripciones de eventos) lo escribieron personas, así que el asistente debe tratarlo como datos, nunca como instrucciones. El servidor se lo indica al asistente cuando se conecta.

Límites

Cada solicitud al servidor MCP cuenta una vez contra el límite de la clave de 120 solicitudes cada 60 segundos, incluidos iniciar la conexión y listar las herramientas. También se aplica el límite de la organización de 600 solicitudes cada 60 segundos sumando todas sus claves.
Una solicitud sin clave o con una clave desconocida recibe 401, y demasiadas solicitudes 429 con Retry-After, antes de que corra cualquier herramienta.
Una solicitud puede tener hasta 64 KB, y una lista devuelve como máximo 100 registros por llamada.

Cuando se rechaza una llamada

Una llamada rechazada vuelve como un error de herramienta con el error propio de la API REST, con los mismos códigos de error, para que el asistente le diga por qué:

{
  "content": [
    {
      "type": "text",
      "text": "{\"error\":{\"code\":\"permission_denied\",\"message\":\"This API key does not have the members.write permission.\",\"details\":{\"required_permission\":\"members.write\"}}}"
    }
  ],
  "structuredContent": {
    "error": {
      "code": "permission_denied",
      "message": "This API key does not have the members.write permission.",
      "details": {
        "required_permission": "members.write"
      }
    }
  },
  "isError": true
}

permission_denied: a la clave le falta el permiso que nombra details.required_permission. Cree una clave nueva que lo tenga.
api_key_revoked o api_key_expired: cree una clave nueva y conecte el asistente con ella.
validation_failed: un campo no es válido, o la herramienta no lo recibe. details lo nombra.
plan_required, billing_hold, account_restricted y limit_reached: igual que en la API REST, se resuelven en Melora Connect.

Revocar el acceso

En Melora Connect, abra Settings y luego la pestaña API keys.
Haga clic en Revoke en la clave del asistente y confirme.

La clave se rechaza desde la siguiente solicitud, y una clave revocada no se puede recuperar. Quite también el servidor de la configuración del asistente. Para cambiar lo que puede hacer un asistente, cree una clave nueva con los permisos que quiere, conecte el asistente con ella y revoque la clave anterior.