Conecta tu asistente de IA
Conecta Claude, ChatGPT u otro cliente MCP a tu portal de cliente. El asistente puede leer tus proyectos, facturas, tickets de soporte, estado del sitio y archivos. En los planes Pro y Ultra también puede abrir tickets o enviar solicitudes de cambio, pero solo después de que confirmes la vista previa exacta.
Herramientas y límites
Cada plan define sus propios límites. El servidor aplica el número de claves, las solicitudes por minuto por clave y las unidades mensuales de toda la cuenta.
Basic
GratisSolo lectura. Sin escrituras en este plan
Consulta proyectos, facturas, tickets de soporte, estado del sitio, archivos del proyecto y el informe mensual.
Pro
3,000,000 Toman / mesLectura y escrituras confirmadas
Todas las herramientas de lectura, más escrituras confirmadas: abrir y responder tickets de soporte, enviar solicitudes de cambio y mensajes de Farr, subir archivos, crear y actualizar borradores de contenido, y aceptar o rechazar propuestas. Cada escritura se muestra primero en vista previa y solo se aplica después de que la apruebes.
Ultra
5,000,000 Toman / mesTodo lo de Pro, más acciones masivas y webhooks
Todo lo de Pro, más acciones masivas sobre tickets (bulk_ticket_reply, bulk_ticket_close y bulk_actions, hasta 20 tickets por llamada), webhooks (webhook_list, webhook_create y webhook_delete) e informes mensuales programados (scheduled_reports y scheduled_reports_get).
Seguridad: sin acciones de pago ni de propiedad
La API del asistente no tiene herramientas para pagar facturas, transferir fondos, cambiar la titularidad de la cuenta ni gestionar claves. Las facturas son de solo lectura. El pago lo realizas tú mismo en el portal del cliente.
Cómo crear una clave de asistente
Crea una clave en el portal del cliente en tres pasos.
1. Inicia sesión en el portal
Accede al portal del cliente y abre Acceso de asistente en el menú.
2. Crea una clave
Haz clic en "Crear clave". Introduce un nombre de 3 a 60 caracteres (por ejemplo, "Claude Code - portátil"), selecciona los permisos y la duración. Para crearla se te solicitará iniciar sesión nuevamente.
3. Copia la clave una sola vez
La clave completa solo se muestra una vez, inmediatamente después de crearla. El servidor solo guarda un hash SHA-256 del secreto. Si la pierdes, revócala y crea una nueva.
Cómo conectar Claude y ChatGPT
Conéctate mediante el transporte MCP Streamable HTTP, usando una clave Bearer o iniciando sesión con OAuth.
Claude Code y otros clientes MCP
En herramientas que aceptan URL de servidor y encabezados, como el archivo .mcp.json de Claude Code, añade esta entrada y sustituye el marcador con tu clave:
{
"mcpServers": {
"sajjad-portal": {
"type": "http",
"url": "https://sajjad.blog/api/client/mcp",
"headers": {
"Authorization": "Bearer <YOUR_AGENT_KEY>"
}
}
}
}ChatGPT y asistentes web
Añade esta dirección como conector personalizado e inicia sesión cuando lo solicite (OAuth). No se necesita clave por esta vía. Los nombres de menú pueden variar según el asistente.
Qué significa "Vista previa y confirmación" en operaciones de escritura
Una modificación nunca se aplica en la primera llamada.
Cuando un asistente invoca una herramienta de escritura, el servidor almacena la solicitud exacta y devuelve una vista previa con un token de confirmación de un solo uso que expira a los 10 minutos. El cambio solo se aplica cuando el asistente invoca la herramienta de confirmación con dicho token tras tu aprobación. Cada token funciona una única vez, para la clave y cuenta emisora y con los mismos argumentos. Cada acción preparada queda registrada.
Referencia de herramientas verificadas
Las herramientas principales que ofrece el endpoint de cliente, además de la herramienta de confirmación que se usa después de una vista previa. Una herramienta fuera de tu plan se rechaza con un mensaje plan_required.
| Nombre de la herramienta | Tipo de acceso | Descripción de la capacidad |
|---|---|---|
| projects_list | Lectura | Lista hasta 50 de tus proyectos: código, nombre, estado, progreso y fecha de finalización. |
| invoices_list | Lectura | Lista hasta 25 facturas con fecha de vencimiento, total, importe pagado, saldo y estado. Usa openOnly para ver solo las pendientes. Se excluyen borradores y enlaces de pago. |
| tickets_list | Lectura | Lista hasta 50 de tus tickets de soporte con estado, prioridad y hora de la última respuesta. |
| ticket_get | Lectura | Obtén el historial de mensajes de un ticket de soporte (hasta 100 mensajes). Se excluyen notas internas. |
| ticket_create | Escritura confirmada | Prepara un nuevo ticket de soporte con prioridad baja o normal. Solo se crea tras confirmar la vista previa. |
| ticket_reply | Escritura confirmada | Prepara una respuesta para un ticket abierto. Los tickets cerrados no admiten respuestas. Solo se envía tras confirmar. |
| change_request_create | Escritura confirmada | Prepara una solicitud de cambio en uno de tus proyectos. Solo se aplica tras confirmar la vista previa. |
| site_status | Lectura | Muestra el estado del dominio, visitantes y páginas vistas (24 horas y 7 días), porcentaje de disponibilidad y errores pendientes del sitio conectado. Datos basados en la última sincronización. |
| files_list | Lectura | Lista archivos en el almacenamiento de proyectos, hasta 100 por página, opcionalmente dentro de una carpeta. |
| file_link | Lectura | Genera un enlace de descarga para un archivo almacenado. El enlace caduca a los 15 minutos. |
| report_monthly | Lectura | Obtén el resumen mensual (hasta 12 meses atrás): proyectos, tickets abiertos y cerrados, estado del sitio, facturas pendientes y un enlace a PDF que caduca en 15 minutos. |
Preguntas frecuentes
Preguntas habituales sobre asistentes para clientes, seguridad y límites de uso.
¿Puede mi asistente de IA realizar pagos o liquidar facturas automáticamente?
No. La API del asistente no incluye herramientas para pagar facturas ni transferir fondos. Las facturas son solo de consulta y el pago lo realizas tú mismo en el portal del cliente.
¿Qué sucede al alcanzar la cuota mensual de unidades?
Cada plan tiene un presupuesto mensual de unidades para toda la cuenta. Una lectura cuesta 1 unidad y una vista previa de escritura cuesta 3. Cuando el uso de la cuenta en el mes alcanza el presupuesto del plan, las llamadas siguientes devuelven un error quota_exceeded dentro del resultado de la herramienta (HTTP 200, no 429) hasta que cambie el mes calendario UTC.
¿Cómo revoco una clave de asistente si se ve comprometida?
Entra en Acceso de asistente en el portal del cliente, selecciona Revocar clave y confirma. Toda solicitud posterior con esa clave será rechazada de inmediato. Los asistentes vinculados mediante OAuth pueden desconectarse desde la misma pantalla.
¿Es necesario configurar un puente local para conectar ChatGPT?
No. El extremo es un punto HTTPS estándar: el cliente envía mensajes JSON-RPC por POST y recibe respuestas JSON. Los asistentes en la nube se conectan directamente sin software local.
¿Listo para poner a trabajar a tu asistente?
Elige un plan para comenzar o accede a tu portal de cliente y genera una clave de asistente.