Ravex-mcp-server

Ravex-mcp-server expone herramientas validadas de Partner API a agentes de IA compatibles con MCP.

Configuración

RAVEX_API_KEY=rk_test_...
RAVEX_API_BASE_URL=https://sandbox.api.ravexapp.com/api/partner/v1
PORT=8787

Para clientes HTTP remotos, envíe el token de portador de Ravex en el encabezado Authorization de la solicitud MCP. El servidor nunca coloca el token en las descripciones de herramientas ni en el contexto del modelo.

Related MCP server: pax8-mcp

Ejecución

npm install
npm run build
RAVEX_API_KEY=rk_test_... npm start

El endpoint HTTP Streamable es /mcp. Para clientes locales que admiten stdio:

RAVEX_API_KEY=rk_test_... node dist/server.js --stdio

Configuración del cliente MCP

Después de implementar este servicio detrás de HTTPS, configure un cliente MCP con la URL implementada:

{
  "mcpServers": {
    "ravex": {
      "url": "https://<your-mcp-host>/mcp",
      "headers": {
        "Authorization": "Bearer rk_test_..."
      }
    }
  }
}

No confirme esta configuración con una clave real. Para alojamiento multiusuario, omita RAVEX_API_KEY en el lado del servidor y exija que cada cliente envíe su propio token de portador. El servicio reenvía ese token únicamente a la API de socios de Ravex.

Las herramientas de escritura requieren una idempotency_key única. Los hosts deben exigir confirmación del usuario antes de invocarlas. Una solicitud exitosa puede seguir en estado processing; los agentes deben conciliar mediante webhooks de Ravex o una consulta de estado en la aplicación host.