Gnesi
Open inbox hello@gnesi.io

Integrations

MCP

Add https://api.gnesi.io/api/mcp in Claude, ChatGPT, Grok, Cursor, and any other MCP client.

The hosted server is https://api.gnesi.io/api/mcp. Protocol 2025-03-26. Methods: initialize, tools/list, tools/call.

Two ways in:

  • Sign-in, for a chat window or a desktop app. The client discovers https://api.gnesi.io/.well-known/oauth-protected-resource and opens https://gnesi.io/connect. Create an account or sign in, then slide to connect. The same window returns to the app. No pasted secret.
  • Bearer, for a client that cannot finish that sign-in. Settings, Agent access. Header Authorization: Bearer. A header named x-api-key is the wrong header on this server.

A missing token on tools/list or tools/call is 401 with WWW-Authenticate pointing at the protected-resource URL. initialize and ping stay open.

This is a custom connector. Search in Claude's or ChatGPT's directory will not find Gnesi. The URL is always https://api.gnesi.io/api/mcp.

Claude on the web

This is a custom connector. It is not a listing in Claude's directory.

Open this link. It prefills the name and the URL. Review them, then continue:

Add Gnesi in Claude

Or do it from the menus:

  1. Open Claude and go to Customize, then Connectors.
  2. Choose Add, then Add custom connector. On a Team or Enterprise plan an owner adds it from Organization settings, Connectors, Add, Custom, Web.
  3. Name it Gnesi. URL https://api.gnesi.io/api/mcp. Continue.
  4. Keep the detected authentication. Choose Sign in now.
  5. For the OAuth client, choose Register automatically. That stores the return address Gnesi will accept.
  6. Add. The Gnesi page opens. Create an account or sign in, then slide to connect.
  7. Claude opens again. Ask "List my Gnesi conversations."

Claude Desktop

The desktop app uses the same connector screen.

  1. Open Claude Desktop and go to Customize, then Connectors.
  2. Choose Add, then Add custom connector.
  3. Name it Gnesi. URL https://api.gnesi.io/api/mcp.
  4. Choose Sign in now, and Register automatically for the OAuth client.
  5. Add. The app opens https://gnesi.io/connect in the browser.
  6. Create an account or sign in, then slide to connect. The browser returns to Claude Desktop.
  7. Ask "List my Gnesi conversations."

Claude Code is a separate install. See CLI.

ChatGPT on the web

This is a custom connector. Search in the app directory will not find Gnesi. The menu says Plugins on current workspace plans, and Apps on others.

  1. Open ChatGPT and go to Plugins. If you do not see Plugins, open Settings, then Apps.
  2. Choose the plus button, then Add custom MCP server. If the menu says Create, use that.
  3. Name it Gnesi. URL https://api.gnesi.io/api/mcp.
  4. Set authentication to sign-in. Do not paste an agent credential.
  5. Create the connector. The Gnesi page opens.
  6. Create an account or sign in, then slide to connect.
  7. ChatGPT opens again. Ask "List my Gnesi conversations."

ChatGPT may ask you to confirm a send before it runs. New mail is covered on MCP events.

ChatGPT desktop app

  1. Open the ChatGPT desktop app.
  2. Open Settings, then MCP servers. If that row is missing, use Plugins, then the manage control next to Installed.
  3. Add a server. Name it Gnesi. Choose Streamable HTTP.
  4. URL https://api.gnesi.io/api/mcp. Save.
  5. Authenticate when the app asks. The Gnesi page opens in the browser.
  6. Create an account or sign in, then slide to connect. The browser returns to the desktop app.

Grok on the web

  1. Open Grok and go to Settings, then Connectors.
  2. Add a custom connector. Name it Gnesi.
  3. URL https://api.gnesi.io/api/mcp.
  4. Connect. The Gnesi page opens.
  5. Create an account or sign in, then slide to connect.
  6. Grok opens again. Ask "List my Gnesi conversations."

Grok app

  1. Open the Grok app and go to Settings, then Connectors.
  2. Add a custom connector with the same name and URL.
  3. Connect. The app opens the Gnesi page in the browser.
  4. Create an account or sign in, then slide to connect. The browser returns to the app.

The Grok CLI and the Grok API use the bearer credential. See Grok.

Cursor

  1. Open Cursor Settings, then MCP.
  2. Add a server named Gnesi with the URL https://api.gnesi.io/api/mcp. Leave the header off.
  3. Connect. Cursor opens the Gnesi page.
  4. Create an account or sign in, then slide to connect. Cursor returns through cursor://.

A terminal-style install can still send the agent credential:

JSON
{
  "gnesi": {
    "url": "https://api.gnesi.io/api/mcp",
    "headers": {
      "Authorization": "Bearer YOUR_CREDENTIAL"
    }
  }
}

Other MCP clients

Use the same URL. If the client can sign you in, leave the credential out. If it asks for a header, send Authorization: Bearer and the agent credential.

Windsurf and any client with a headers field follow the Cursor block. Codex takes the same URL in its MCP settings.

Tools

The server returns the live list from tools/list. The names and arguments are on MCP. Older names that say task still work. New clients use the conversation names.

An agent credential that reads a conversation does not receive the body of a message Shield is holding. The shield object is still on the message. gnesi_release_shield is refused for an agent credential.