Talk To Gina

Lee hilos y archivos de Gina, envía tareas, ejecuta rutinas y responde aprobaciones mediante OAuth con alcance. Requiere una cuenta Gina de acceso anticipado con acceso de agente.

Servidor MCP alojado

npx add-mcp 'https://app.talktogina.ai/api/mcp'

Se instala en Claude Code, Codex, Cursor y más

Documentación

Claves de API para otras herramientas

Una clave de agente permite que otra herramienta de IA (ChatGPT, Cursor, Claude o tu propio software) trabaje con un agente a través del Protocolo de Contexto de Modelo (MCP): añades el agente a la herramienta como conector, y la herramienta actúa como tú, sin más acceso del que tú tienes. Una herramienta que admita OAuth puede iniciar sesión con Gina AI en lugar de usar una clave.

01

Crear una clave

Abre el agente en la consola y elige Acceso en el Menú; las claves de API están debajo de las personas. Los propietarios, administradores y operadores pueden crear claves. Nombra la clave según la herramienta que la usará, elige qué puede hacer y cuándo expira.

La clave se muestra una sola vez. Cópiala directamente en la herramienta; si la pierdes, revócala y crea otra.

02

Conecta tu herramienta de IA

Úsala desde tus herramientas de IA

Una vez conectada, una herramienta puede leer los hilos y archivos de este agente, enviarle tareas, responder a sus aprobaciones y ejecutar sus programaciones, como tú, con el acceso que elegiste. La URL del servidor MCP es https://app.talktogina.ai/api/mcp. Iniciar sesión desde una herramienta también crea una clave aquí, para que puedas revocarla de la misma manera.

ChatGPT· inicia sesión con Gina AI, sin necesidad de pegar una clave

  1. En ChatGPT, abre Configuración → Seguridad e inicio de sesión y activa Modo desarrollador. Que se ofrezca o no depende de tu cuenta y de la política del espacio de trabajo.
  2. Ve a Plugins, selecciona el botón de más y dale a la conexión un nombre y una descripción.
  3. En Conexión, introduce la URL del servidor MCP:
    https://app.talktogina.ai/api/mcp
    
    Copiar
  4. Crea la conexión. Cuando ChatGPT lo pida, inicia sesión con Gina AI, elige este agente y selecciona Permitir. ChatGPT entonces lista las herramientas que encontró.
  5. En un chat nuevo, añade la conexión desde el menú de herramientas.

ChatGPT se conecta solo iniciando sesión; no puede enviar una clave pegada, así que no necesitas crear una para ello.

Cursor· usa una clave

  1. Abre Personalizar en la barra lateral y luego MCPs; o edita ~/.cursor/mcp.json (cada proyecto) o .cursor/mcp.json dentro de un proyecto.
  2. Añade este servidor:
    {
      "mcpServers": {
        "my-agent": {
          "url": "https://app.talktogina.ai/api/mcp",
          "headers": {
            "Authorization": "Bearer <your key>"
          }
        }
      }
    }
    
    Copiar
  3. Guarda. Cursor se conecta y muestra las herramientas del agente bajo ese nombre. Claude Code· usa una clave, o inicia sesión con Gina AI
  4. En una terminal, ejecuta:
    claude mcp add --transport http my-agent https://app.talktogina.ai/api/mcp --header "Authorization: Bearer <your key>"
    
    Copiar
  5. Para iniciar sesión en lugar de usar una clave, omite --header y luego ejecuta /mcp dentro de Claude Code y sigue el aviso del navegador. Claude (web y escritorio)· inicia sesión con Gina AI, o usa una clave
  6. Ve a Personalizar → Conectores, haz clic en + Añadir y luego en Añadir conector personalizado.
  7. Ponle nombre y pega la URL del servidor MCP:
    https://app.talktogina.ai/api/mcp
    
    Copiar
  8. En Cliente OAuth elige Registrar automáticamente; en Autenticación elige Iniciar sesión ahora, inicia sesión con Gina AI, elige este agente y selecciona Permitir.
  9. Con una clave en su lugar: en Encabezados de solicitud añade Authorization: Bearer <your key> y elige Sin inicio de sesión.
  10. En un chat, abre + → Conectores y actívalo.

En un plan de Equipo o Empresa, un propietario lo añade en Configuración de la organización → Conectores (Añadir → Personalizado → Web), y los miembros hacen clic en Conectar.

La página de Acceso muestra estos pasos con tu clave ya completada justo después de crear una.

Cualquier otro cliente MCP: añade un servidor remoto con la URL https://app.talktogina.ai/api/mcp y el encabezado Authorization: Bearer <key>, o deja que inicie sesión con Gina AI si admite OAuth. El servidor habla Streamable HTTP (JSON-RPC 2.0 sobre POST).

Gemini CLI, Codex, VS Code con GitHub Copilot y otras herramientas que añaden un servidor MCP remoto (HTTP) funcionan de la misma manera: dales la URL y luego inicia sesión con Gina AI cuando se abra tu navegador, o añade el encabezado con una clave.

ChatGPT deep research y otras herramientas que buscan en un conector pueden buscar las conversaciones de este agente y los nombres de sus archivos, y luego leer un resultado completo. Usan las herramientas search y fetch, que solo necesitan read:tasks.

03

Qué permite cada alcance

AlcancePermiteHerramientas
read:tasksLeer hilos, lo que está esperando por ti, programaciones y archivos, y buscarlos.threads_list, threads_read, approvals_list, schedules_list, files_list, files_read, search, fetch
write:tasksEnviar tareas al agente y ejecutar una programación ahora.threads_send_task, schedules_fire_now
cancel:tasksCancelar tareas en ejecución.(ninguna aún)
approve:tasksAprobar o denegar una solicitud abierta, con una nota.approvals_answer

Una clave nunca puede llevar un alcance que tu propio rol no tenga. Responder aprobaciones requiere ser propietario o administrador, o estar designado para aprobar en la página de Acceso, y el agente aún verifica cada decisión contra sus reglas de aprobación.

04

Caducidad y revocación

Las claves caducan después de 90 días por defecto (máximo 365). Revoca una clave desde la página de Acceso y dejará de funcionar en su siguiente uso. Un propietario puede revocar la clave de cualquiera en su agente.

Una clave también deja de funcionar por sí sola si se elimina tu acceso al agente, si tu rol se reduce por debajo de lo que la clave lleva, o si se elimina tu cuenta. Cada uso queda registrado.

**⚠ Nota:**Una clave puede enviar trabajo a tu agente, y tu agente guarda tus credenciales. Trata una clave como una contraseña: mantenla fuera de archivos compartidos y chats, dale solo los alcances que la herramienta necesita, y revócala cuando dejes de usar la herramienta.

05

Clientes de aplicación, para apps que piden un ID de cliente

La mayoría de las herramientas de IA se configuran solas cuando las conectas. Algunas apps en cambio piden un ID de cliente y un secreto antes de poder conectarse, como Microsoft Copilot Studio (configuración manual), Gemini Enterprise o n8n con credenciales fijas. Crea uno en la página de Acceso, en Clientes de aplicación; los propietarios y administradores pueden crearlos y revocarlos.

  • Nombre: la app para la que es.
  • URLs de redirección: la URL de callback o redirección que la app te muestra, una por línea. Cada una comienza con https:// (o http://localhost para una app en tu propio ordenador).
  • Tipo: Con secreto para la mayoría de las apps que piden uno, o Sin secreto para una app que usa solo PKCE.

Pulsa Crear cliente de aplicación y copia el ID de cliente, el Secreto de cliente (mostrado una sola vez), la URL de autorización, la URL de token (también la URL de refresco) y los Alcances en la app. Si la app pregunta sobre PKCE, actívalo con S256.

Un cliente no concede nada por sí solo: cada persona aún inicia sesión con Gina AI, solo puede conectarse a este agente y no obtiene más acceso del que tiene. Revoca un cliente desde la lista cuando la app ya no lo necesite.