Talk To Gina

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

API keys for other tools

An agent key lets another AI tool (ChatGPT, Cursor, Claude, or your own software) work with one agent over the Model Context Protocol (MCP): you add the agent to the tool as a connector, and the tool acts as you, with no more access than you have. A tool that supports OAuth can sign in with Gina AI instead of using a key.

01

Create a key

Open the agent in the console and choose Access in the Menu; API keys are below the people. Owners, admins and operators can create keys. Name the key after the tool that will use it, choose what it may do, and choose when it expires.

The key is shown once. Copy it straight into the tool; if you lose it, revoke it and create another.

02

Connect your AI tool

Use it from your AI tools

Once connected, a tool can read this agent’s threads and files, send it tasks, answer its approvals and run its schedules, as you, with the access you chose. The MCP server URL is https://app.talktogina.ai/api/mcp. Signing in from a tool creates a key here too, so you can revoke it the same way.

ChatGPT· signs in with Gina AI, no key to paste

1. In ChatGPT, open Settings → Security and login and turn on Developer mode. Whether it is offered depends on your account and workspace policy.
2. Go to Plugins, select the plus button, and give the connection a name and description.
3. Under Connection, enter the MCP server URL:

   https://app.talktogina.ai/api/mcp
   

   Copy
4. Create the connection. When ChatGPT asks, sign in with Gina AI, pick this agent and choose Allow. ChatGPT then lists the tools it found.
5. In a new chat, add the connection from the tools menu.

ChatGPT connects by signing in only; it cannot send a pasted key, so you do not need to create one for it.

Cursor· uses a key

1. Open Customize in the sidebar, then MCPs; or edit ~/.cursor/mcp.json (every project) or .cursor/mcp.json inside one project.
2. Add this server:

   {
     "mcpServers": {
       "my-agent": {
         "url": "https://app.talktogina.ai/api/mcp",
         "headers": {
           "Authorization": "Bearer <your key>"
         }
       }
     }
   }
   

   Copy
3. Save. Cursor connects and shows the agent’s tools under that name. Claude Code· uses a key, or signs in with Gina AI
4. In a terminal, run:

   claude mcp add --transport http my-agent https://app.talktogina.ai/api/mcp --header "Authorization: Bearer <your key>"
   

   Copy
5. To sign in instead of using a key, leave out --header, then run /mcp inside Claude Code and follow the browser prompt. Claude (web and desktop)· signs in with Gina AI, or uses a key
6. Go to Customize → Connectors, click + Add, then Add custom connector.
7. Name it and paste the MCP server URL:

   https://app.talktogina.ai/api/mcp
   

   Copy
8. Under OAuth client choose Register automatically; under Authentication choose Sign in now, sign in with Gina AI, pick this agent and choose Allow.
9. With a key instead: under Request headers add Authorization: Bearer <your key> and choose No sign in.
10. In a chat, open + → Connectors and switch it on.

On a Team or Enterprise plan an owner adds it under Organization settings → Connectors (Add → Custom → Web), and members click Connect.

The Access page shows these steps with your key filled in right after you create one.

Any other MCP client: add a remote server with the URL https://app.talktogina.ai/api/mcp and the header Authorization: Bearer <key>, or let it sign in with Gina AI if it supports OAuth. The server speaks Streamable HTTP (JSON-RPC 2.0 over POST).

Gemini CLI, Codex, VS Code with GitHub Copilot, and other tools that add a remote (HTTP) MCP server work the same way: give them the URL, then sign in with Gina AI when your browser opens, or add the header with a key.

ChatGPT deep research and other tools that search a connector can search this agent’s conversations and the names of its files, then read a result in full. They use the search and fetch tools, which need only read:tasks.

03

What each scope allows

Scope	Allows	Tools
read:tasks	Read threads, what is waiting on you, schedules and files, and search them.	threads_list, threads_read, approvals_list, schedules_list, files_list, files_read, search, fetch
write:tasks	Send the agent tasks and run a schedule now.	threads_send_task, schedules_fire_now
cancel:tasks	Cancel running tasks.	(none yet)
approve:tasks	Approve or deny an open request, with a note.	approvals_answer

A key can never carry a scope your own role lacks. Answering approvals needs owner or admin, or being designated to approve on the Access page, and the agent still checks each decision against its approval rules.

04

Expiry and revocation

Keys expire after 90 days by default (at most 365). Revoke a key from the Access page and it stops working on its next use. An owner can revoke anyone’s key on their agent.

A key also stops working on its own if your access to the agent is removed, if your role is lowered below what the key carries, or if your account is deleted. Every use is recorded.

**⚠ Note:**A key can send your agent work, and your agent holds your credentials. Treat a key like a password: keep it out of shared files and chat, give it only the scopes the tool needs, and revoke it when you stop using the tool.

05

App clients, for apps that ask for a client ID

Most AI tools set themselves up when you connect them. Some apps instead ask for a client ID and secret before they can connect, such as Microsoft Copilot Studio (manual setup), Gemini Enterprise, or n8n with fixed credentials. Make one on the Access page, under App clients; owners and admins can create and revoke them.

• Name: the app it is for.
• Redirect URLs: the callback or redirect URL the app shows you, one per line. Each starts with https:// (or http://localhost for an app on your own computer).
• Type: With a secret for most apps that ask for one, or No secret for an app that uses PKCE only.

Press Create app client and copy the Client ID, the Client secret (shown once), the Authorization URL, the Token URL (also the refresh URL) and the Scopes into the app. If the app asks about PKCE, turn it on with S256.

A client grants nothing on its own: each person still signs in with Gina AI, can connect only this agent, and gets no more access than they have. Revoke a client from the list when the app no longer needs it.