There There
There There (there-there.app) MCP — herramientas de helpdesk con IA para tickets, contactos, conocimiento y canales mediante OAuth.
Servidor MCP alojado
npx add-mcp 'https://there-there.app/mcp'Se instala en Claude Code, Codex, Cursor y más
Documentación
Servidor MCP
¿Qué es MCP?
El Protocolo de Contexto de Modelo es un estándar abierto que permite a los clientes de IA (Claude Desktop, ChatGPT, Cursor, VS Code y otros) llamar a herramientas que se ejecutan en un servidor remoto. There There incluye un servidor MCP, por lo que una vez que conectas tu cliente de IA, el asistente puede leer tus tickets, clasificarlos, responder a los clientes y editar tu base de conocimiento directamente, sin salir del cliente de IA.
Las conexiones están limitadas a un usuario, pero pueden otorgar acceso a uno o más espacios de trabajo. El usuario elige los espacios de trabajo en la pantalla de consentimiento. Cada llamada a una herramienta se ejecuta como ese usuario y cumple las mismas reglas de acceso a canales que el panel de control.
URL del servidor
https://there-there.app/mcp
El endpoint habla JSON-RPC 2.0 sobre HTTP y solo acepta solicitudes POST. También hay una URL de descubrimiento en https://there-there.app/.well-known/oauth-protected-resource que los clientes de IA leen automáticamente para encontrar el flujo de OAuth.
Cómo conectarse
La mayoría de los clientes te guían a través de OAuth: haces clic en Conectar, There There abre una pantalla de consentimiento donde eliges el espacio de trabajo y las capacidades a otorgar, haces clic en Permitir y el cliente queda conectado. Nunca necesitas copiar un token manualmente.
Claude Code (CLI)
Ejecuta esto en tu terminal:
claude mcp add there-there --transport http https://there-there.app/mcp --scope user
La bandera --scope user hace que There There esté disponible en todos tus proyectos. Déjala fuera si solo quieres la conexión en el proyecto actual.
La primera vez que el asistente usa una herramienta, tu navegador abre la pantalla de consentimiento de There There. Después de hacer clic en Permitir, vuelves a Claude y la conexión está activa.
Claude Desktop, ChatGPT, Cursor, VS Code
Cada uno de estos clientes expone un "conector MCP personalizado" o una configuración equivalente. La ruta exacta del menú varía según la versión, pero el único valor que cualquiera de ellos necesita es la URL del servidor:
https://there-there.app/mcp
Cuando el cliente llama a una herramienta por primera vez, abre tu navegador, eliges el espacio de trabajo y las capacidades en la pantalla de consentimiento de There There, y la conexión queda activa.
Para clientes que aceptan configuración JSON (algunas versiones de Cursor, por ejemplo), la entrada se ve así:
{
"mcpServers": {
"there-there": {
"url": "https://there-there.app/mcp"
}
}
}
Otros clientes
Cualquier cliente MCP que admita transporte HTTP con OAuth 2.1 (PKCE con el método de desafío S256, más Registro Dinámico de Clientes según RFC 7591) funcionará. Apúntalo a la URL del servidor y descubrirá todo lo demás a través de /.well-known/oauth-protected-resource.
La pantalla de consentimiento
Cuando un cliente de IA se conecta por primera vez, There There muestra una pantalla donde eliges:
- Qué espacios de trabajo debe poder usar la conexión. Marca uno o más. Solo ves los espacios de trabajo a los que perteneces.
- Qué capacidades otorgar. Cada capacidad es una casilla; la conexión no puede usar ninguna herramienta cuya capacidad no hayas marcado.
Las mismas capacidades se aplican a todos los espacios de trabajo que marques. Elige el conjunto más pequeño que necesites.
Puedes revocar la conexión en cualquier momento desde Configuración, Aplicaciones conectadas.
Actuar en múltiples espacios de trabajo
Si marcaste más de un espacio de trabajo, cada llamada a una herramienta lleva un argumento workspace_ulid que elige sobre qué espacio de trabajo actúa. La IA ve la lista de espacios de trabajo otorgados (con sus nombres e ids) en las instrucciones del servidor, así que cuando dices "tickets en Spatie", el asistente elige el id correcto automáticamente.
Si solo marcaste un espacio de trabajo, workspace_ulid es opcional. La conexión usa ese espacio de trabajo por defecto y la IA no necesita pensar en ello.
Nunca necesitas buscar un ID de espacio de trabajo para una conexión OAuth. Solo lo necesitas cuando te conectas con un token de API.
Capacidades
Las capacidades son lo que el cliente de IA puede hacer. There There tiene cuatro:
| Capacidad | Qué permite |
|---|---|
mcp:read | Listar y leer tickets, contactos, canales y la base de conocimiento. |
mcp:tickets:manage | Clasificar tickets: cambiar estado, asignar, etiquetar, establecer campos personalizados, añadir notas internas. |
mcp:tickets:reply | Enviar respuestas y reenvíos a los clientes, y crear nuevos tickets salientes. El cliente recibe estos mensajes. |
mcp:knowledge:write | Crear, actualizar y eliminar artículos del cerebro. |
Elige el conjunto más pequeño que necesites. Una conexión con solo mcp:read no puede responder accidentalmente a un cliente, incluso si la IA lo intenta.
La capacidad de respuesta está marcada en la pantalla de consentimiento porque el cliente ve el resultado. Las otras capacidades son internas.
Herramientas
Las herramientas disponibles para una conexión se filtran según las capacidades que otorgaste. Una conexión sin mcp:tickets:reply ni siquiera verá reply-to-ticket-tool en su lista de herramientas.
Herramientas de lectura (mcp:read)
| Herramienta | Descripción |
|---|---|
list-tickets-tool | Listar tickets en el espacio de trabajo. Filtrar por estado, canal, etiqueta, contacto, asignado, campo personalizado y una búsqueda de texto libre sobre el asunto. |
get-ticket-tool | Obtener un solo ticket junto con su hilo de mensajes y sus campos personalizados. |
search-tickets-tool | Búsqueda semántica en tickets y mensajes por significado, no solo por texto del asunto. Úsala para consultas temáticas como "tickets sobre errores de exportación". |
lookup-contacts-tool | Encontrar contactos por correo electrónico o nombre. Devuelve hasta 10 coincidencias con recuentos recientes de tickets. |
search-knowledge-tool | Buscar en los artículos del cerebro y la documentación. |
list-channels-tool | Listar los canales a los que el usuario puede acceder. |
Herramientas de clasificación (mcp:tickets:manage)
| Herramienta | Descripción |
|---|---|
change-ticket-status-tool | Establecer un ticket como abierto, en espera, cerrado o spam. |
assign-ticket-tool | Asignar un ticket a un usuario o a un equipo, o desasignar uno de ellos. |
add-note-to-ticket-tool | Publicar una nota interna. Las notas solo son visibles para los compañeros de equipo, nunca para el cliente. |
add-tag-to-ticket-tool | Añadir una etiqueta existente del espacio de trabajo a un ticket. |
remove-tag-from-ticket-tool | Eliminar una etiqueta de un ticket. |
set-ticket-custom-field-tool | Establecer un campo personalizado en un ticket. Llama a get-ticket-tool primero para los ids de campo y opción que le corresponden. |
Herramientas de respuesta (mcp:tickets:reply)
| Herramienta | Descripción |
|---|---|
reply-to-ticket-tool | Enviar una respuesta al cliente a través del canal del ticket. |
forward-ticket-tool | Reenviar un mensaje específico de un ticket a uno o más destinatarios. |
create-ticket-tool | Iniciar un nuevo ticket saliente: elige un canal, proporciona el correo del destinatario, el asunto y el cuerpo. |
Herramientas de conocimiento (mcp:knowledge:write)
| Herramienta | Descripción |
|---|---|
create-brain-article-tool | Crear un nuevo artículo en un cerebro. Los artículos nuevos se crean como borrador (privado) para que no aparezcan en el widget hasta que los publiques. |
update-brain-article-tool | Actualizar el título, el cuerpo o la visibilidad de un artículo existente. |
delete-brain-article-tool | Eliminar un artículo del cerebro. |
Acceso a canales
Si tu equipo usa canales restringidos (canales que no todos los miembros pueden ver), las llamadas a herramientas de IA cumplen esas reglas. La conexión solo puede ver y actuar sobre tickets en canales a los que tú mismo tienes acceso. Los tickets en canales a los que no puedes acceder devuelven "no encontrado" en lugar de un error de permiso, para que la IA no pueda sondear su existencia.
Registro de auditoría
Cada llamada a una herramienta se registra en el espacio de trabajo con el nombre de la herramienta, el usuario, la conexión, la duración y si tuvo éxito. Puedes revisar la actividad de una conexión haciendo clic en ella en Configuración, Aplicaciones conectadas.
Los campos sensibles se redactan en el registro de auditoría. El cuerpo de una respuesta, reenvío o nota, el asunto y el cuerpo de un nuevo ticket saliente, y el título y el cuerpo de un artículo del cerebro creado o actualizado se reemplazan con [REDACTED] en la entrada del registro. Las listas de destinatarios en respuestas, reenvíos y tickets salientes también se redactan. El mensaje o artículo real conserva el contenido original; solo se enmascara la fila de auditoría.
Gestión de conexiones
Configuración, Aplicaciones conectadas lista cada conexión de IA activa para el espacio de trabajo actual. Desde allí puedes:
- Ver qué capacidades tiene cada conexión.
- Abrir una conexión para ver sus llamadas a herramientas recientes y cualquier error.
- Revocar una conexión. Revocar invalida inmediatamente los tokens de la conexión; el cliente de IA tiene que reconectarse para volver a usar cualquier herramienta.
Cada usuario gestiona sus propias conexiones. Otras personas en el espacio de trabajo no pueden ver ni revocar las tuyas.
Tokens de API (avanzado)
Si prefieres usar un token de acceso personal en lugar de OAuth, puedes crear uno en Configuración, Tokens de API. El nivel de permiso del token decide qué capacidades obtiene sobre MCP:
| Permiso del token | Capacidades MCP |
|---|---|
| Lectura y escritura | Las cuatro: mcp:read, mcp:tickets:manage, mcp:tickets:reply, mcp:knowledge:write |
| Solo lectura | mcp:read |
El token también necesita acceso al espacio de trabajo en el que quieres actuar. Envía el token en el encabezado Authorization. Si el token puede acceder a más de un espacio de trabajo, las llamadas a herramientas eligen un espacio de trabajo con el argumento workspace_ulid, igual que una conexión OAuth. Para fijar la conexión a un solo espacio de trabajo, envía su ID de espacio de trabajo en X-Workspace-Id. Puedes copiar el ID desde Configuración, Tokens de API, que lista cada espacio de trabajo al que perteneces, o desde Configuración, Espacio de trabajo, General. Consulta Cómo encontrar tu ID de espacio de trabajo.
POST /mcp
Authorization: Bearer <token>
X-Workspace-Id: <workspace-id>
Content-Type: application/json
Se recomienda OAuth para clientes de IA porque el flujo de consentimiento es más amigable y la conexión es por cliente. Usa tokens de API para scripts y CI.
Límites
- Cada conexión tiene un límite de velocidad por minuto. Si alcanzas el límite, la respuesta es HTTP 429 y el cliente de IA debe reintentar después de una pausa breve.
- Los cuerpos de respuestas y reenvíos están limitados a 100,000 caracteres. Los cuerpos de notas están limitados a 50,000. Los cuerpos de artículos del cerebro están limitados a 200,000. Estos límites evitan que las solicitudes descontroladas superen los límites de las columnas de la base de datos.
- Los asuntos de tickets salientes están limitados a 998 caracteres (el límite de línea RFC 5322).
Solución de problemas
El cliente de IA dice que no puede conectarse. Verifica que puedas alcanzar https://there-there.app/mcp desde la misma máquina. Algunas redes corporativas bloquean POST a hosts desconocidos.
La pantalla de consentimiento dice que no pertenezco a ningún espacio de trabajo. Necesitas ser miembro de al menos un espacio de trabajo antes de poder conectar un cliente de IA.
Una herramienta devuelve "no encontrado" para un ticket que sé que existe. La conexión probablemente no tiene acceso al canal de ese ticket. Abre el ticket en el panel de control para confirmarlo. Si tampoco puedes verlo allí, pide a un propietario del espacio de trabajo que otorgue acceso.
La IA sigue pidiendo permiso. Tu conexión puede estar revocada o caducada. Abre Configuración, Aplicaciones conectadas y verifica si la conexión sigue listada. Si no, reconéctate desde el cliente de IA.
Mis respuestas no llegan a los clientes. Verifica que el canal esté configurado para enviar correo (Configuración, Canales, la sección Enviar del canal). Cuando creas un nuevo ticket saliente a través de create-ticket-tool, la herramienta se niega de antemano si el canal no está listo para enviar.