Proxenio MCP Server

Servidor MCP para la red de intenciones verificadas de Proxenio que permite a los agentes de IA recuperar coincidencias verificadas y aceptar presentaciones con controles de confianza heredados.

Documentación

Servidor MCP de Proxenio

Servidor MCP (Protocolo de Contexto de Modelo) para la red de intención verificada de Proxenio. Permite a los agentes de IA que se ejecutan en Claude Desktop, Cursor, VS Code y otros clientes compatibles con MCP descubrir e interactuar con el motor de emparejamiento profesional de Proxenio.

Qué Hace

Este servidor le brinda a tu agente de IA cuatro herramientas:

HerramientaQué hace
proxenio_discoverAprende sobre la plataforma, el modelo de confianza y la API — sin necesidad de autenticación
proxenio_set_api_keyConfigura tu clave API de Proxenio para la autenticación
proxenio_get_matchesLee los emparejamientos profesionales verificados de tu principal
proxenio_accept_matchAcepta una solicitud de presentación, creando un trato

Tu agente hereda el nivel de confianza del principal humano. Ve exactamente lo que ve el principal — el mismo motor de emparejamiento, las mismas reglas, las mismas puertas de verificación. Sin atajos.

Requisitos Previos

  • Node.js 18+
  • Una cuenta de Proxenio con correo electrónico verificado y perfil completado
  • Una clave API generada en proxenio.ai/agents

Instalación

npx @proxenio-tech/mcp-server

Uso con Claude Desktop

Agrega a tu configuración de Claude Desktop (claude_desktop_config.json):

{
  "mcpServers": {
    "proxenio": {
      "command": "npx",
      "args": ["@proxenio-tech/mcp-server"]
    }
  }
}

Luego, en Claude Desktop, puedes decir:

"¿Qué es Proxenio?"
→ Claude usa proxenio_discover automáticamente

"Conéctate a Proxenio con esta clave: prx_YOUR_KEY_HERE_________________"
→ Claude usa proxenio_set_api_key

"Muéstrame mis emparejamientos profesionales"
→ Claude usa proxenio_get_matches

"Acepta la presentación de Maria Georgiou"
→ Claude usa proxenio_accept_match

Uso con Cursor

Agrega a tu configuración de MCP de Cursor:

{
  "proxenio": {
    "command": "npx",
    "args": ["@proxenio-tech/mcp-server"]
  }
}

Despliegue Remoto (HTTP)

Para despliegue multi-cliente o en la nube:

TRANSPORT=http PORT=3001 node dist/index.js

El servidor expone:

  • POST /mcp — endpoint del protocolo MCP
  • GET /health — verificación de salud

Referencia de Herramientas

proxenio_discover

No requiere autenticación. Devuelve información de la plataforma, modelo de confianza, capacidades y enlaces.

proxenio_set_api_key

ParámetroTipoRequeridoDescripción
api_keystringSíClave API completa (36 caracteres, comienza con prx_)

proxenio_get_matches

ParámetroTipoPredeterminadoDescripción
filter_typeall|top|high|standardallFiltrar por calidad de emparejamiento
filter_statusall|pending|acceptedallFiltrar por estado
min_scorenumber (40-100)40Puntuación mínima de emparejamiento

Devuelve: Información del principal, emparejamientos con perfiles de contrapartes, niveles de confianza, puntuaciones y estado del límite de tasa.

proxenio_accept_match

ParámetroTipoRequeridoDescripción
match_idstring (UUID)SíID de emparejamiento de proxenio_get_matches

Devuelve: Confirmación, detalles de la contraparte, nuevo ID de trato, estado del límite de tasa.

Barreras de protección: El principal debe ser la parte receptora. No se pueden aceptar solicitudes propias. El emparejamiento debe estar activo con una presentación pendiente.

Modelo de Confianza

  • Los agentes heredan el nivel de confianza de su principal humano en el momento de la solicitud
  • Niveles de confianza: 0 (No verificado) → 1 (Principiante) → 2 (Activo) → 3 (Confiado) → 4 (Probado)
  • Todas las puertas de verificación del motor se aplican — los agentes no pueden omitir ninguna
  • Las contrapartes ven una insignia de transparencia: 🤖 AI Agent active on behalf of [Name]
  • Solo los humanos pueden registrar resultados y confirmar tratos

Límites de Tasa

  • 60 solicitudes/hora por clave API
  • Máximo 3 claves por usuario (= 180 solicitudes/hora en total)
  • Los encabezados de límite de tasa se incluyen en todas las respuestas

Seguridad

  • Las claves API nunca se registran ni se almacenan en el servidor MCP
  • Las claves se validan por formato antes de su uso (prefijo, longitud)
  • Toda la comunicación utiliza HTTPS
  • El servidor MCP actúa como un paso directo — no se almacenan datos en caché

Enlaces

Licencia

MIT — Proxenio Technologies Ltd