Asistente de IA (MCP)

CongPlan puede conectarse a un asistente de IA mediante la interfaz MCP (Model Context Protocol). Esto le permite hacer preguntas de planificación en lenguaje natural o dictar entradas en lugar de navegar por los menús. El asistente lee y escribe los mismos datos que la aplicación, de modo que cada acción pasa por las mismas comprobaciones de permisos y de conflictos, y queda registrada en el registro de auditoría.

Estándar abierto

MCP es un estándar abierto, por lo que la conexión funciona con cualquier asistente compatible con MCP. CongPlan expone un punto de conexión MCP por congregación y usa OAuth 2.1 para la autorización. Si su cliente admite OAuth, se conecta simplemente con la URL del punto de conexión e inicia sesión a través de CongPlan; no se necesita ningún token. Un token de acceso personal solo es necesario para clientes sin compatibilidad con OAuth, o cuando necesite una credencial estática y de larga duración.

Antes de empezar

El acceso a MCP está desactivado de forma predeterminada. Son necesarios dos pasos antes de poder usarlo:

1. Un administrador activa la interfaz MCP para la congregación (en los ajustes de administración).
2. Un administrador le concede acceso para que pueda conectar un asistente, ya sea mediante inicio de sesión OAuth o creando un token personal. Si todavía no tiene acceso, puede solicitarlo desde la pantalla de MCP.

Conectar su asistente

El punto de conexión MCP de CongPlan es https://my.congplan.app/api/mcp.

Claude.ai / Claude Desktop

1. Abra los ajustes de su cuenta de Claude (llamados Settings o Customize, según su plan) y busque Connectors > Add custom connector.
2. Pegue la URL del punto de conexión que aparece abajo. Claude abre un navegador para iniciar sesión a través de CongPlan y completa la conexión OAuth automáticamente: no se necesita ningún token.

https://my.congplan.app/api/mcp

Claude Code CLI

# OAuth (recommended): opens a browser to log in to CongPlan
claude mcp add --transport http congplan https://my.congplan.app/api/mcp

# Personal access token (fallback for non-interactive/CI use)
claude mcp add --transport http congplan https://my.congplan.app/api/mcp \
  --header "Authorization: Bearer cpm_your_token_here"

ChatGPT (conector personalizado)

1. En ChatGPT, abra Settings y busque Connectors (la redacción exacta del menú puede variar según el plan o la versión de la app); elija añadir o crear un conector nuevo.
2. Pegue la URL del punto de conexión y complete el inicio de sesión OAuth. No se necesita ningún token: los conectores de ChatGPT admiten OAuth directamente.

mcp.json genérico (Cursor, Windsurf, etc.)

Los clientes que leen su lista de servidores MCP desde un archivo mcp.json admiten cualquiera de los dos tipos de conexión: use OAuth si el cliente lo admite, o un token bearer en caso contrario:

{
  "mcpServers": {
    "congplan-oauth": {
      "url": "https://my.congplan.app/api/mcp"
    },
    "congplan-token": {
      "url": "https://my.congplan.app/api/mcp",
      "headers": {
        "Authorization": "Bearer cpm_your_token_here"
      }
    }
  }
}

Pedir a su asistente que se configure solo

Muchos asistentes pueden configurar la conexión ellos mismos si pega una breve instrucción:

Add the CongPlan MCP server at https://my.congplan.app/api/mcp using OAuth.
If OAuth isn't supported, ask me for a personal access token and use it as an
Authorization: Bearer header instead.

Tokens de acceso personal

Solo necesita un token si su cliente no puede usar OAuth o necesita una credencial de larga duración.

Una vez que tenga acceso, cree un token personal en los ajustes de su cuenta:

1. Abra Yo > Integraciones.
2. Elija Crear token.
3. Asigne al token un nombre, seleccione los ámbitos que puede usar y elija una caducidad (hasta 90 días).
4. Copie el token de inmediato: se muestra solo una vez y no se puede recuperar después.

Use un token en el asistente compatible con MCP que prefiera para conectarlo con su congregación.

Ámbitos

Los ámbitos controlan exactamente qué puede hacer un token. Se dividen en lectura y escritura por área, por ejemplo:

• Lectura — perfil de la congregación, publicadores, grupos de predicación, reuniones, asignaciones (incluidas las asignaciones técnicas), reuniones para el servicio del campo, tareas, testificación pública, discursos públicos salientes y (sensible) ausencias.
• Escritura — tareas, reuniones para el servicio del campo, asignaciones, reuniones, testificación pública, y sus propias solicitudes de cesión o inscripciones.

Conceda solo los ámbitos que realmente necesite. Un token puede revocarse en cualquier momento.

Solicitudes basadas en el nombre

Cuando le pide al asistente que actúe sobre publicadores concretos, por ejemplo «registra una ausencia para Linda y Tim», primero debe resolver esos nombres en los ID de publicador internos de CongPlan. Conceda el ámbito Lectura de publicadores junto con el ámbito de escritura correspondiente, como Escritura de ausencias, para que el asistente pueda buscar a las personas que debe actualizar.

Si falta el ámbito de lectura de publicadores, el asistente no puede encontrar con seguridad a la persona correcta. Debería pedirle que añada ese ámbito o que indique los ID exactos. Si falta un nombre o coincide con más de un publicador, debería pedir aclaraciones en lugar de adivinar.

Ejemplos de solicitudes

Lo que diga depende del asistente, pero las solicitudes típicas se parecen a esto:

• «¿Quién está asignado en la reunión entre semana de la próxima semana?»
• «¿Qué partes siguen sin asignar para la reunión de fin de semana del 14 de julio?»
• «¿Qué reuniones están programadas para la próxima semana?»
• «Anota al hermano Miller como orador del discurso público del 14 de julio.»
• «Crea una tarea: revisar los micrófonos para la reunión de fin de semana del sábado.»
• «Muéstrame todas las reuniones para el servicio del campo de esta semana con el conductor y el punto de encuentro.»
• «¿Quién tiene el micrófono o el servicio de audio/vídeo este fin de semana?»
• «¿Cuáles de nuestros oradores tienen un discurso público saliente programado el próximo mes?»
• «Crea la reunión de fin de semana del 16 de agosto.»

El asistente propone la acción; esta se guarda por las mismas vías que una entrada manual, incluidas las comprobaciones de idoneidad y de conflictos. Cuando le pides que cree una reunión nueva, CongPlan aplica automáticamente la plantilla de programa correspondiente —la misma que se aplicaría si la crearas a mano—, de modo que la reunión no queda vacía. Si no coincide ninguna plantilla (o pides explícitamente una reunión vacía), se crea sin programa.

Anonimizado de forma predeterminada

La interfaz MCP entrega a su asistente los ID internos de los publicadores, no los nombres. La planificación, las estadísticas y las comprobaciones de idoneidad se ejecutan todas sobre esos ID. Cuando el asistente revisa quién fue asignado recientemente para equilibrar la carga, evalúa ese historial de forma anonimizada, sin ver quiénes son las personas.

Los nombres solo se resuelven al final, para la respuesta que se le muestra, y únicamente para las pocas personas que esa respuesta realmente menciona. Esta búsqueda es un paso aparte que requiere el ámbito Lectura de publicadores, y no devuelve más que los nombres visibles de los ID consultados, sin listado completo ni más detalles. Sin ese ámbito, el asistente sigue trabajando con ID, simplemente no puede asociarles nombres.

Permisos y seguridad

• El asistente solo puede hacer lo que permitan su rol y sus ámbitos de OAuth o de token: se aplican el mismo aislamiento entre congregaciones y las mismas reglas de permisos que en la aplicación.
• Cada acción queda registrada en el registro de auditoría.
• Los tokens son personales. Trate un token como una contraseña y revóquelo si ya no lo necesita.

Relacionado

• Permisos
• Tareas