Conectar un asistente de IA

TCultura le responde a un asistente de inteligencia artificial sobre actividades culturales. Le puedes preguntar qué hay este fin de semana en tu comuna, si queda cupo en un taller o cuánto cuesta una entrada, y la respuesta trae el enlace para inscribirte.

Si además conectas tu cuenta, responde sobre lo tuyo: a qué actividades estás inscrito, qué tienes en la agenda, cómo va tu Pasaporte Cultural. Y si formas parte de un proyecto cultural, responde sobre su gestión: asistencia, encuestas, indicadores y rendiciones.

Qué necesitas antes de empezar

• Para buscar en la cartelera, nada: esa parte responde sin conectar ninguna cuenta.
• Para lo tuyo, una cuenta de TCultura. La tienes desde que te inscribes a una actividad.
• Para la gestión de un proyecto, ser parte de su equipo. La conexión no crea proyectos: consulta el que ya tienes.
• Un asistente que acepte conectores. En la versión web de Claude y de ChatGPT esa función viene en los planes de pago, y en ChatGPT hay que activarla en los ajustes avanzados de la cuenta.

La dirección del servidor

Es la misma para cualquier proyecto y es lo único que hay que copiar:

https://mcp.tcultura.com/mcp

Camino 1: con tu asistente en el navegador

Es el camino corto y no necesita ningún archivo ni ninguna clave. Sirve para Claude y para ChatGPT en su versión web.

1. Abre los conectores de tu asistente. En los ajustes de tu cuenta busca la sección de conectores, y dentro de ella la opción de agregar uno personalizado.
2. Pega la dirección del servidor. Es https://mcp.tcultura.com/mcp, la misma para cualquier proyecto. No hay nada más que completar en esa pantalla.
3. Autoriza con tu cuenta de TCultura. El asistente te trae a una pantalla de TCultura donde inicias sesión y eliges qué autorizas: uno de tus proyectos, o solo tu cuenta. Ahí termina la conexión.
4. Retírala cuando quieras. Las conexiones activas se ven en la pestaña Llaves, con quién las autorizó y hasta cuándo valen. Al retirar una, ese asistente deja de responder de inmediato.

Camino 2: con un programa instalado en tu computador

Si trabajas con un asistente instalado, la conexión se declara en un archivo de configuración. Ahí sí hace falta una clave, que se emite desde el panel y se ve una sola vez. Donde abajo dice tck_TU_LLAVE va esa clave.

{
  "mcpServers": {
    "tcultura": {
      "type": "http",
      "url": "https://mcp.tcultura.com/mcp",
      "headers": {
        "Authorization": "Bearer tck_TU_LLAVE"
      }
    }
  }
}

[mcp_servers.tcultura]
url = "https://mcp.tcultura.com/mcp"
bearer_token_env_var = "TCULTURA_MCP_TOKEN"

{
  "mcpServers": {
    "tcultura": {
      "url": "https://mcp.tcultura.com/mcp",
      "headers": {
        "Authorization": "Bearer tck_TU_LLAVE"
      }
    }
  }
}

{
  "mcpServers": {
    "tcultura": {
      "serverUrl": "https://mcp.tcultura.com/mcp",
      "headers": {
        "Authorization": "Bearer tck_TU_LLAVE"
      }
    }
  }
}

{
  "mcpServers": {
    "tcultura": {
      "serverUrl": "https://mcp.tcultura.com/mcp",
      "headers": {
        "Authorization": "Bearer tck_TU_LLAVE"
      }
    }
  }
}

{
  "mcpServers": {
    "tcultura": {
      "command": "npx",
      "args": [
        "-y",
        "mcp-remote",
        "https://mcp.tcultura.com/mcp",
        "--header",
        "Authorization:${TCULTURA_AUTH}"
      ],
      "env": {
        "TCULTURA_AUTH": "Bearer tck_TU_LLAVE"
      }
    }
  }
}

Qué le puedes pedir

La cartelera, sin conectar nada

Responden sin credencial y muestran lo mismo que la agenda pública del sitio. Cada respuesta trae el enlace para inscribirte o comprar en TCultura.

• buscar_actividades: Busca actividades culturales publicadas: conciertos, talleres, obras, exposiciones.
• hay_cupo: Si una actividad publicada todavía tiene cupo disponible, ahora mismo.
• ver_actividad: Detalle de una actividad publicada: fecha, lugar, descripción, entradas y precios.

Tu cuenta, si conectas

Responden sobre ti y sobre nadie más.

• mi_agenda: Lo que tengo por delante: actividades a las que voy y turnos de voluntariado, en orden.
• mi_pasaporte: Mi Pasaporte Cultural: cuántos sellos llevo, qué nivel tengo y dónde he estado.
• mi_voluntariado: En qué programas de voluntariado participo, cuántas horas llevo y qué turnos tengo.
• mis_certificados: Qué certificados tengo y de qué actividad.
• mis_encuestas_pendientes: Las encuestas que me toca responder y todavía no respondí.
• mis_inscripciones: Las actividades a las que estoy inscrito, con su fecha y su lugar.
• mis_premios: Qué gané en sorteos y si ya lo retiré.

Consultar un proyecto

Estas solo leen y responden.

• consultar_proyecto: Los datos generales del proyecto: nombre, plan contratado y organización propietaria.
• panorama: Estado general del proyecto en una sola llamada, para arrancar con contexto.
• listar_eventos: Los eventos del proyecto con sus conteos de inscripción y asistencia.
• listar_participantes: Cuántas personas hay inscritas y cuántas asistieron, con el enlace a la nómina.
• ver_kpis: Los indicadores de gestión del proyecto, con su valor actual y su meta.
• ver_indicadores: Indicadores compuestos del proyecto con la evidencia que los hace interpretables.
• ver_resultados_pregunta: Distribución de respuestas de una pregunta, entera o abierta por una dimensión de corte.
• ver_respuestas_encuesta: Cuántas respuestas tiene una encuesta y qué pregunta, con el enlace a los resultados.
• ver_asistencia: Asistencia real por evento, con el desglose que hace defendible el número ante un fondo.
• ver_pasaporte: Visitas registradas como sellos del Pasaporte Cultural en los eventos del proyecto.
• listar_concursos: Los concursos de fotografía del proyecto, con su estado y su volumen de participación.
• ver_concurso: Cómo va un concurso: fotos recibidas, en qué estado de moderación están y cuántos votos.
• listar_unidades: Organizaciones y unidades del proyecto, con los identificadores que aceptan los cortes.
• ver_voluntariado: Programas de voluntariado con su dotación, turnos y horas acumuladas.
• ver_sponsors: Auspiciadores del proyecto, leads capturados por QR y reportes generados.
• listar_sorteos: Sorteos del proyecto, sus premios, cuántos ganaron y el historial de ejecuciones.
• ver_networking: Ruedas de negocios del proyecto: participantes, citas y resultados declarados.
• ver_encuestas_resumen: Los instrumentos del proyecto con cuántas respuestas tiene cada uno.
• ver_estado_rendicion: El estado de las rendiciones de fondos del proyecto y qué falta para cerrarlas.
• ver_rendicion_detalle: Marco lógico, presupuesto y avance de la rendición del proyecto.
• resumen_ejecutivo: Redacta un resumen ejecutivo del proyecto a partir de sus datos.
• listar_biblioteca_formularios: Lista preguntas de biblioteca y grupos de opciones reutilizables.

Preparar cambios

Estas escriben, y lo que crean nace sin publicar: queda como propuesta hasta que una persona la revisa en el panel.

• crear_evento: Prepara un evento cultural del proyecto.
• crear_formulario: Crea formulario de encuesta con secciones y opciones reales.
• crear_formulario_desde_plantilla: Copia una plantilla de encuesta completa para este proyecto.
• crear_tipo_entrada: Prepara un tipo de entrada para un evento, con su precio y su cupo.
• generar_rendicion: Prepara el borrador de una rendición de fondos con los datos que ya están en el sistema.
• editar_pregunta: Cambia campos de una pregunta existente.
• agregar_pregunta: Agrega una pregunta al final de una encuesta.
• archivar_pregunta: Deja de mostrar una pregunta conservando las respuestas ya recibidas.
• reordenar_preguntas: Cambia el orden en que se muestran las preguntas de una encuesta.
• editar_evento: Cambia datos de un evento: nombre, descripción, fecha, lugar u organizador.
• archivar_evento: Saca un evento de circulación: deja de ser público y cierra las inscripciones.
• confirmar_accion: Ejecuta la acción que quedó en espera después de mostrarse en una vista previa.
• cargar_encuesta_de_papel: Carga una encuesta que se respondió en papel, a partir del texto que transcribiste.
• adjuntar_foto_de_papel: Adjunta la foto del papel a una respuesta que ya cargaste, como fuente de la transcripción.

Qué no sale por esta vía

Los datos de las personas de un proyecto. Se entregan conteos, totales, indicadores agregados y direcciones de pantallas de la plataforma. No se entregan nombres, correos, teléfonos, RUT ni respuestas individuales de nadie: cuando la pregunta apunta a una persona, la respuesta es un número y el enlace a la pantalla de TCultura donde ese dato vive, detrás del inicio de sesión.

Y hay algo que no sale nunca, ni siquiera cuando preguntas por lo tuyo: el número y el código de una entrada, el código de tu Pasaporte Cultural, el archivo de un certificado y el código de canje de un premio. Con cualquiera de esos se entra a una actividad o se retira un premio, así que se ven en TCultura con tu sesión y no viajan a una conversación.

Cada consulta queda registrada con su fecha, la herramienta usada y la conexión que la hizo, y ese registro se puede revisar desde el panel.

El detalle de cómo tratamos la información está en nuestra política de privacidad.

Si algo no funciona

Escríbenos a soporte@tcultura.com con el nombre de tu proyecto y qué asistente estás usando.