Talk To Gina

Leia threads e arquivos da Gina, envie tarefas, execute rotinas e responda aprovações via OAuth com escopo. Requer uma conta Gina de acesso antecipado com acesso de agente.

Ver em talktogina.ai

Servidor MCP hospedado

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

Instala no Claude Code, Codex, Cursor e outros

Documentação

Chaves de API para outras ferramentas

Uma chave de agente permite que outra ferramenta de IA (ChatGPT, Cursor, Claude ou seu próprio software) trabalhe com um agente por meio do Model Context Protocol (MCP): você adiciona o agente à ferramenta como um conector, e a ferramenta age como você, sem ter mais acesso do que você tem. Uma ferramenta que suporta OAuth pode entrar com a Gina AI em vez de usar uma chave.

01

Criar uma chave

Abra o agente no console e escolha Access no Menu; API keys ficam abaixo das pessoas. Proprietários, administradores e operadores podem criar chaves. Dê à chave o nome da ferramenta que a usará, escolha o que ela pode fazer e escolha quando ela expira.

A chave é mostrada apenas uma vez. Copie-a diretamente para a ferramenta; se você a perder, revogue-a e crie outra.

02

Conecte sua ferramenta de IA

Use-a a partir de suas ferramentas de IA

Depois de conectada, uma ferramenta pode ler os tópicos e arquivos deste agente, enviar tarefas a ele, responder às suas aprovações e executar seus agendamentos, como você, com o acesso que você escolheu. A URL do servidor MCP é https://app.talktogina.ai/api/mcp. Entrar a partir de uma ferramenta também cria uma chave aqui, para que você possa revogá-la da mesma forma.

ChatGPT· entra com a Gina AI, sem chave para colar

  1. No ChatGPT, abra Settings → Security and login e ative o Developer mode. Se isso é oferecido depende da sua conta e da política do espaço de trabalho.
  2. Vá para Plugins, selecione o botão de adição e dê à conexão um nome e uma descrição.
  3. Em Connection, insira a URL do servidor MCP: 
    https://app.talktogina.ai/api/mcp
    Copiar
  4. Crie a conexão. Quando o ChatGPT pedir, entre com a Gina AI, escolha este agente e selecione Allow. O ChatGPT então lista as ferramentas que encontrou.
  5. Em um novo chat, adicione a conexão pelo menu de ferramentas.

O ChatGPT conecta-se apenas entrando; ele não pode enviar uma chave colada, então você não precisa criar uma para ele.

Cursor· usa uma chave

  1. Abra Customize na barra lateral e depois MCPs; ou edite ~/.cursor/mcp.json (todos os projetos) ou .cursor/mcp.json dentro de um projeto.
  2. Adicione este servidor: 
    {
  "mcpServers": {
    "my-agent": {
      "url": "https://app.talktogina.ai/api/mcp",
      "headers": {
        "Authorization": "Bearer <your key>"
      }
    }
  }
}
    Copiar
  3. Salve. O Cursor conecta-se e mostra as ferramentas do agente sob esse nome. Claude Code· usa uma chave ou entra com a Gina AI
  4. Em um terminal, execute: 
    claude mcp add --transport http my-agent https://app.talktogina.ai/api/mcp --header "Authorization: Bearer <your key>"
    Copiar
  5. Para entrar em vez de usar uma chave, omita --header e depois execute /mcp dentro do Claude Code e siga o prompt do navegador. Claude (web e desktop)· entra com a Gina AI ou usa uma chave
  6. Vá para Customize → Connectors, clique em + Add e depois em Add custom connector.
  7. Dê um nome e cole a URL do servidor MCP: 
    https://app.talktogina.ai/api/mcp
    Copiar
  8. Em OAuth client, escolha Register automatically; em Authentication, escolha Sign in now, entre com a Gina AI, escolha este agente e selecione Allow.
  9. Com uma chave em vez disso: em Request headers, adicione Authorization: Bearer <your key> e escolha No sign in.
  10. Em um chat, abra + → Connectors e ative-o.

Em um plano Team ou Enterprise, um proprietário o adiciona em Organization settings → Connectors (Add → Custom → Web), e os membros clicam em Connect.

A página Access mostra estas etapas com sua chave preenchida logo após você criar uma.

Qualquer outro cliente MCP: adicione um servidor remoto com a URL https://app.talktogina.ai/api/mcp e o cabeçalho Authorization: Bearer <key>, ou deixe-o entrar com a Gina AI se ele suportar OAuth. O servidor fala Streamable HTTP (JSON-RPC 2.0 sobre POST).

Gemini CLI, Codex, VS Code com GitHub Copilot e outras ferramentas que adicionam um servidor MCP remoto (HTTP) funcionam da mesma forma: forneça a URL e depois entre com a Gina AI quando o navegador abrir, ou adicione o cabeçalho com uma chave.

ChatGPT deep research e outras ferramentas que pesquisam um conector podem pesquisar as conversas deste agente e os nomes de seus arquivos e depois ler um resultado por completo. Elas usam as ferramentas search e fetch, que precisam apenas de read:tasks.

03

O que cada escopo permite

EscopoPermiteFerramentas
read:tasksLer tópicos, o que está aguardando você, agendamentos e arquivos, e pesquisá-los.threads_list, threads_read, approvals_list, schedules_list, files_list, files_read, search, fetch
write:tasksEnviar tarefas ao agente e executar um agendamento agora.threads_send_task, schedules_fire_now
cancel:tasksCancelar tarefas em execução.(nenhuma ainda)
approve:tasksAprovar ou negar uma solicitação aberta, com uma nota.approvals_answer

Uma chave nunca pode carregar um escopo que seu próprio papel não tenha. Responder a aprovações exige ser proprietário ou administrador, ou ser designado para aprovar na página Access, e o agente ainda verifica cada decisão de acordo com suas regras de aprovação.

04

Expiração e revogação

As chaves expiram após 90 dias por padrão (no máximo 365). Revogue uma chave pela página Access e ela para de funcionar no próximo uso. Um proprietário pode revogar a chave de qualquer pessoa em seu agente.

Uma chave também para de funcionar sozinha se seu acesso ao agente for removido, se seu papel for rebaixado abaixo do que a chave carrega ou se sua conta for excluída. Cada uso é registrado.

⚠ Nota: Uma chave pode enviar trabalho ao seu agente, e seu agente guarda suas credenciais. Trate uma chave como uma senha: mantenha-a fora de arquivos compartilhados e chats, dê a ela apenas os escopos que a ferramenta precisa e revogue-a quando parar de usar a ferramenta.

05

Clientes de aplicativo, para aplicativos que pedem um client ID

A maioria das ferramentas de IA se configura sozinha quando você as conecta. Alguns aplicativos, em vez disso, pedem um client ID e um secret antes de poderem se conectar, como Microsoft Copilot Studio (configuração manual), Gemini Enterprise ou n8n com credenciais fixas. Crie um na página Access, em App clients; proprietários e administradores podem criá-los e revogá-los.

  • Name: o aplicativo para o qual é.
  • Redirect URLs: a URL de callback ou redirecionamento que o aplicativo mostra a você, uma por linha. Cada uma começa com https:// (ou http://localhost para um aplicativo no seu próprio computador).
  • Type: With a secret para a maioria dos aplicativos que pedem um, ou No secret para um aplicativo que usa apenas PKCE.

Pressione Create app client e copie o Client ID, o Client secret (mostrado uma vez), a Authorization URL, a Token URL (também a URL de atualização) e os Scopes para o aplicativo. Se o aplicativo perguntar sobre PKCE, ative-o com S256.

Um cliente não concede nada por conta própria: cada pessoa ainda entra com a Gina AI, pode conectar apenas este agente e não recebe mais acesso do que tem. Revogue um cliente da lista quando o aplicativo não precisar mais dele.