Connect an agent

An agent connects to Hookspot through one URL, the MCP server’s. Add it to your agent, then approve the agent in your browser.

https://app.hookspot.dev/mcp

Enter the URL exactly as shown. With a trailing slash, Hookspot refuses the agent’s sign-in. Account settings › Authorized apps in Hookspot shows the URL too.

Add the server

Pick your agent. Each one opens Hookspot in your browser to sign in.

Claude Code

Add the server for every directory:

claude mcp add --scope user --transport http hookspot https://app.hookspot.dev/mcp

Then start claude, run /mcp, select hookspot and choose Authenticate. Claude Code opens Hookspot in your browser.

Codex

Add the server:

codex mcp add hookspot --url https://app.hookspot.dev/mcp

The command then opens Hookspot in your browser. Codex confirms in the terminal once you approve.

If no browser opens, open the URL that Codex prints.

To sign in again later, run codex mcp login hookspot. The Codex IDE extension and the ChatGPT desktop app read the same server list.

Cursor

Add Hookspot to Cursor. The link opens Cursor and installs the server.

Or add the server to ~/.cursor/mcp.json yourself:

~/.cursor/mcp.json

{
  "mcpServers": {
    "hookspot": {
      "url": "https://app.hookspot.dev/mcp"
    }
  }
}

When Cursor shows that hookspot needs you to sign in, follow its prompt. Cursor opens Hookspot in your browser.

While Cursor registers itself with Hookspot, Hookspot shows Unverified next to its name.

Cursor passes its agent at most about 40 tools. An agent connected without Read-only gets more tools than that.

If the agent can’t find a tool, turn off tools you don’t use in Cursor’s MCP settings. If the agent only reads, revoke its app and connect the agent again as Read-only instead.

VS Code

Agent mode in VS Code needs GitHub Copilot, and its Free plan is enough.

Add Hookspot to VS Code. The link opens VS Code and asks you to install the server.

Or add it from a terminal:

code --add-mcp '{"name":"hookspot","type":"http","url":"https://app.hookspot.dev/mcp"}'

When VS Code asks to sign in to hookspot, allow it. VS Code opens Hookspot in your browser.

claude.ai

Add Hookspot as a custom connector on claude.ai:

1. Open Customize › Connectors.
2. Click Add, then Add custom connector.
3. Enter the name Hookspot and the server URL, then click Continue.
4. Keep the authentication settings Claude detects, with Sign in now and Use Claude’s published identity.
5. Click Add. Claude opens Hookspot to sign in.

To use it in a chat, click +, choose Connectors and turn on Hookspot. Claude Desktop and the Claude mobile apps use the connectors you add on claude.ai.

A Free Claude plan holds one custom connector. On Team and Enterprise, an owner adds the connector, and each member clicks Connect next to it.

ChatGPT

Add Hookspot as a custom MCP server on chatgpt.com:

1. Open Plugins and click +.
2. Choose Add custom MCP server.
3. Enter the name Hookspot and the server URL.
4. Choose OAuth for authentication.
5. Read the warning and click I understand and want to continue.
6. Click Create as a plugin, then install it.

ChatGPT opens Hookspot to sign in. To use it in a chat, type @ and pick Hookspot.

Your ChatGPT plan and your workspace’s settings decide whether you can add a custom MCP server, and whether ChatGPT runs its tools that make changes. By default, ChatGPT asks you to confirm each call that makes changes.

Approve the agent

In the browser:

1. Sign in to Hookspot if it asks.
2. Check that the page names the agent you are connecting.
3. Tick Read-only if the agent should only read.
4. Click Approve.

Hookspot sends you back to the agent, which lists Hookspot’s tools. Authorized apps explains the approval page and how to revoke an agent.

Check the connection

Ask the agent:

List my Hookspot projects.

The agent answers with the projects of every organization you belong to.