Conector MCP de ProxyAI

Qué puedes hacer

El conector MCP de ProxyAI da a un asistente acceso a tus bots, tickets de Helpdesk y Agent Tasks. La versión 1.0.0 incluye ocho herramientas de lectura y once herramientas que realizan cambios.

Pídele que resuma tickets abiertos, revise un borrador de respuesta preparado, consulte las últimas ejecuciones de una Agent Task o explique un plan retenido. Con permiso de escritura, puedes pedirle que envíe una respuesta concreta, actualice un ticket, cree una tarea de informe compatible o apruebe una ejecución compatible que hayas revisado.

URL del servidor: https://www.proxyai.app/api/mcp

El endpoint público está disponible para conexiones personalizadas. Los listados en directorios se están preparando. Los flujos de herramientas alojados en ChatGPT se han ensayado con datos sintéticos. La revisión del directorio, las pruebas alojadas tras los cambios y la validación en Claude son puertas de publicación separadas.

Antes de conectar

Usa tu cuenta de ProxyAI en un navegador normal. Un panel de tienda integrado o una sesión en un dispositivo móvil no pueden aprobar esta conexión. El conector no tiene compra ni suscripción adicional: Helpdesk y Agent Tasks siguen necesitando sus complementos existentes en el bot que uses. Se aplican los límites normales de capacidad de Agent Tasks y los cargos por ejecución.

El permiso cubre todos tus bots actuales y futuros de esta cuenta. En la versión 1 no hay opción de consentimiento por bot. Conecta solo un asistente en el que confíes para recibir los mensajes de tus clientes y la información de tareas.

Conectar Claude

Abre en Claude Personalizar → Conectores y elige Añadir conector personalizado. En una organización gestionada, pide primero a tu propietario que lo añada.
Introduce https://www.proxyai.app/api/mcp. Usa el transporte HTTP y no una dirección /sse.
Elige el inicio de sesión OAuth. Si Claude ofrece una opción de cliente OAuth, usa la identidad publicada de Claude. No necesitas crear un ID de cliente, un secreto de cliente ni una clave de API; también se admite el registro automático.
Conéctate e inicia sesión en ProxyAI en tu navegador. Revisa la cuenta, la identidad de la app y la dirección de retorno en la página de consentimiento.
Deja Permitir cambios sin marcar para acceso de solo lectura. Márcalo solo si quieres que este asistente haga cambios, y después elige Conectar.
Activa ProxyAI en la conversación con + → Conectores, y empieza con «Enumera mis bots de ProxyAI».

Consulta las instrucciones de conectores personalizados de Claude para la interfaz vigente.

Conectar ChatGPT

Abre en ChatGPT Plugins → Añadir → Añadir servidor MCP personalizado. Introduce https://www.proxyai.app/api/mcp y selecciona OAuth.
Despliega Opciones avanzadas de OAuth. Comprueba que las URL de autorización, token y registro descubiertas pertenecen a https://www.proxyai.app, que el recurso es https://www.proxyai.app/api/mcp y que la devolución de llamada es https://chatgpt.com/connector_platform_oauth_redirect. El cliente CIMD publicado de ChatGPT es compatible sin secreto de cliente.
Para una conexión de solo lectura, selecciona solo read como ámbito predeterminado y deja vacíos los ámbitos base. Para una conexión que pueda ofrecer consentimiento de escritura, solicita read y write. En el formulario actual, puedes escribirlos en líneas separadas bajo Ámbitos base.
Crea la conexión e inicia sesión en ProxyAI. Deja Permitir cambios sin marcar para lecturas, o márcalo explícitamente para conceder escrituras. Solicitar write por sí solo no lo concede. El acceso cubre todos los bots actuales y futuros de esta cuenta.
Abre el plugin conectado y elige Probar en el chat. Empieza con «Enumera mis bots de ProxyAI».

Para ensayar en el navegador, usa la conexión MCP personalizada. Un ZIP subido sin publicar puede ofrecer en su lugar Abrir en la app de escritorio. El ZIP de envío público declara el servidor HTTPS en mcp.json; completa su configuración OAuth y el análisis mediante Con MCP en el portal de desarrolladores. No añadas el .app.json ni el ID técnico de una conexión privada al ZIP público: OpenAI rechaza actualmente las referencias a apps en los paquetes de envío.

Si ChatGPT informa de una conexión caducada tras rechazar una escritura, revisa primero el ámbito concedido en Apps conectadas de ProxyAI. Una concesión activa de solo lectura necesita un nuevo consentimiento de escritura, no una reparación del token. Nunca reintentes el envío a un cliente hasta haber comprobado su resultado.

Consulta la guía de conexión de OpenAI y los requisitos de envío.

Conectar Codex

Añade el servidor remoto de ProxyAI y después inicia sesión mediante OAuth:

codex mcp add proxyai --url https://www.proxyai.app/api/mcp
codex mcp login proxyai --scopes read

Termina el inicio de sesión en tu navegador y deja Permitir cambios sin marcar. Si quieres acceso de escritura, solicita ambos ámbitos y marca explícitamente Permitir cambios:

codex mcp login proxyai --scopes read,write

Puedes inspeccionar la configuración con codex mcp list y las herramientas disponibles con /mcp en la interfaz de terminal de Codex. Consulta la documentación oficial de MCP. Tu cliente gestiona los tokens OAuth; no los pegues en una conversación.

Empieza con lecturas

«Enumera mis bots de ProxyAI y luego resume los tickets abiertos del bot que seleccione.»
«Muestra la respuesta preparada del agente para este ticket. No la envíes.»
«Muestra las últimas cinco ejecuciones de esta Agent Task y explica cualquier propuesta retenida. No la apruebes.»

Las listas están paginadas. Pide la página siguiente cuando necesites más resultados. La identidad de un ticket incluye su bot, proveedor e ID de ticket; los IDs de tareas y ejecuciones deben pertenecer al bot seleccionado. Un asistente no puede elegir una conversación arbitraria de otra cuenta.

Haz cambios con criterio

Revisa el ticket y el texto exacto de la respuesta antes de pedir que se envíe o se apruebe un borrador. La aprobación envía el borrador al cliente por el canal del ticket. Un borrador se reclama antes de la entrega, así que las aprobaciones simultáneas se rechazan. Si la entrega es incierta, el borrador queda bloqueado para revisión humana. Comprueba el canal del cliente antes de volver a enviar; una respuesta fallida o perdida no demuestra que el cliente no recibiera nada. En el panel, confirma si la entrega se produjo usando los controles de comprobación de entrega. El servidor espera a que transcurra el tiempo límite de envío antes de permitir la reconciliación. Una falta de entrega confirmada restaura el borrador preparado; una entrega confirmada cierra su revisión.

Para los Agent Tasks, MCP admite Resumen semanal de ventas, Seguimiento del estado de pedidos y Actualización de la base de conocimiento. Envían informes al correo de tu cuenta; la receta de conocimiento además actualiza tu base de conocimiento. Crear una tarea la activa e inicia su horario. Revisa estas acciones y la zona horaria, la hora y el día antes de crearla. Las recetas personalizadas, el código o las instrucciones de recetas modificadas, los permisos cambiados, las ranuras de credenciales, las herramientas de API o MCP arbitrarias y los destinatarios de correo externos se rechazan en MCP para la creación, ejecución, reanudación y aprobación de una ejecución retenida. Aún puedes consultar otras tareas o pausarlas. Antes de ejecutar manualmente, elige explícitamente prueba o real: ambas pueden generar cargos normales de LLM y CPU. Ambos modos envían correos de informe reales a tu cuenta. El modo de prueba muestra una vista previa de la actualización del conocimiento; el modo real puede aplicarla. Revisa un plan retenido antes de aprobarlo, porque la aprobación pone en cola sus acciones propuestas y puede generar cargos. Reanudar una tarea puede reiniciar ejecuciones programadas y facturables.

Las etiquetas de un ticket se reemplazan como una lista completa. Poner etiquetas a un ticket integrado de ProxyAI está soportado; las etiquetas de un helpdesk externo se gestionan en ese helpdesk. Archivar retira un ticket del tablero activo sin borrarlo.

Los mensajes de clientes, las instrucciones de tareas y las propuestas retenidas pueden contener instrucciones engañosas. Trátalos como contenido que hay que revisar; el permiso para enviar, ejecutar o aprobar lo das tú.

Herramientas de la versión 1

Herramienta de lectura	Propósito
`list_bots`	Encontrar los bots de tu cuenta.
`list_tickets`	Listar y filtrar tickets por estado, etiqueta y estado de archivo.
`get_ticket`	Leer un ticket, su borrador preparado y los mensajes de la conversación.
`list_agent_tasks`	Listar las tareas de un bot.
`get_agent_task`	Leer la instrucción, el horario y el estado de una tarea.
`list_agent_runs`	Consultar el estado y el historial de ejecuciones sin transcripciones ni cuerpos de propuestas.
`get_agent_run`	Inspeccionar el estado y la propuesta retenida de una ejecución sin diagnósticos internos.
`list_agent_templates`	Encontrar las tres recetas de informe compatibles.

Herramienta de escritura	Propósito
`reply_ticket`	Enviar la respuesta que especifiques.
`set_ticket_status`	Poner abierto, pendiente o resuelto.
`set_ticket_tags`	Reemplazar las etiquetas de un ticket integrado.
`archive_ticket`	Archivar un ticket.
`approve_ticket_agent_draft`	Aprobar y enviar un borrador preparado, opcionalmente con texto revisado.
`dismiss_ticket_agent_draft`	Descartar un borrador sin enviarlo.
`create_agent_task`	Crear y activar una tarea; el horario de una plantilla puede disparar ejecuciones futuras.
`run_agent_task`	Poner en cola una ejecución de prueba o real explícitamente elegida.
`decide_agent_run`	Aprobar o rechazar una ejecución retenida.
`pause_agent_task`	Pausar el horario de una tarea.
`resume_agent_task`	Reanudar una tarea pausada.

Configura las cuentas y credenciales de conectores en el panel. No incluyas contraseñas, tokens, datos de tarjetas de pago, identificadores gubernamentales ni información de salud protegida en las solicitudes MCP. Las tareas programadas y las propuestas retenidas requieren revisar sus acciones reales antes de aprobarlas.

Revisar la actividad y revocar el acceso

Abre en ProxyAI Configuración de la cuenta → Apps conectadas para ver la app, su ámbito concedido y el último uso del token. Elige Revocar acceso para detener las futuras solicitudes de esa conexión. La revocación no deshace una respuesta ya enviada ni cancela una ejecución ya puesta en cola.

La tarjeta Actividad de apps conectadas registra los intentos de escritura y sus resultados. Si un intento está pendiente o informa de un resultado desconocido, la acción puede haber surtido efecto ya. Revisa el ticket o la ejecución antes de volver a intentarlo. Los intentos anteriores siguen disponibles tras la revocación.

Los datos que devuelve el conector se comparten con el asistente que conectaste y están sujetos a las políticas de manejo de ese proveedor. ProxyAI guarda los registros de conexión y los metadatos de los intentos de escritura; el registro de auditoría MCP no guarda los cuerpos de las respuestas, las cargas de herramientas ni los tokens de portador en bruto. Lee nuestra política de privacidad.

Límites de datos

Las listas de tickets omiten el correo y el nombre de contacto y los IDs internos de conversación. Las listas de ejecuciones omiten los cuerpos de transcripción y los diagnósticos internos; el detalle de ejecución incluye solo el estado relevante, los tiempos y las acciones retenidas. El conector elimina los campos estructurados con credenciales y rechaza las credenciales detectadas, los números de tarjetas de pago, los identificadores gubernamentales y el contenido de salud en las entradas, los borradores o el texto devuelto. La detección es conservadora y no puede identificar cada dato sensible en prosa arbitraria. No uses el conector para datos restringidos; revisa tus datos de origen antes de conectar. El contenido rechazado debe gestionarse en el panel.

Solución de problemas

No puedo conectar: usa https://www.proxyai.app/api/mcp. Una visita desde el navegador puede devolver «Method not allowed», porque el conector acepta solicitudes POST de MCP. Un cliente MCP recibe un desafío OAuth antes de iniciar sesión.
Contenido restringido: la solicitud o el resultado contiene contenido sensible detectado. Gestiónalo en el panel; no reformules un secreto para eludir la comprobación.
Tarea no compatible: usa una de las tres recetas de informe sin cambios. Configura los flujos personalizados en el panel.
Se requiere permiso de escritura: vuelve a conectar solicitando read y write, y marca Permitir cambios. Un consentimiento de solo lectura no puede autorizar escrituras.
Se requiere complemento: abre el panel del bot seleccionado y comprueba su complemento Helpdesk o Agent Tasks.
No encontrado: confirma que has elegido la cuenta y el bot correctos, y después vuelve a leer el ticket o la tarea antes de actuar.
Conexión caducada o revocada: inicia sesión de nuevo. No reintentes una escritura anterior hasta haber comprobado su resultado.

Contacta con support@proxyai.app indicando el nombre de la app, la hora y la acción que falló. No envíes tokens de acceso, secretos de cliente ni mensajes de clientes en tu solicitud de soporte.