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:
| Herramienta | Qué hace |
|---|---|
proxenio_discover | Aprende sobre la plataforma, el modelo de confianza y la API — sin necesidad de autenticación |
proxenio_set_api_key | Configura tu clave API de Proxenio para la autenticación |
proxenio_get_matches | Lee los emparejamientos profesionales verificados de tu principal |
proxenio_accept_match | Acepta 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 usaproxenio_discoverautomáticamente
"Conéctate a Proxenio con esta clave: prx_YOUR_KEY_HERE_________________"
→ Claude usaproxenio_set_api_key
"Muéstrame mis emparejamientos profesionales"
→ Claude usaproxenio_get_matches
"Acepta la presentación de Maria Georgiou"
→ Claude usaproxenio_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 MCPGET /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ámetro | Tipo | Requerido | Descripción |
|---|---|---|---|
api_key | string | Sí | Clave API completa (36 caracteres, comienza con prx_) |
proxenio_get_matches
| Parámetro | Tipo | Predeterminado | Descripción |
|---|---|---|---|
filter_type | all|top|high|standard | all | Filtrar por calidad de emparejamiento |
filter_status | all|pending|accepted | all | Filtrar por estado |
min_score | number (40-100) | 40 | Puntuació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ámetro | Tipo | Requerido | Descripción |
|---|---|---|---|
match_id | string (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
- Plataforma: proxenio.ai
- Documentación de Agentes: proxenio.ai/agents/docs
- Manifiesto de Descubrimiento: .well-known/proxenio.json
- Especificación OpenAPI: api/agent/openapi.json
Licencia
MIT — Proxenio Technologies Ltd