Agent integrations

Connect an agentic assistant to Assertive

Link ChatGPT, Claude, or Claude Code to your Assertive workspace over MCP. Your agentic assistant signs in with OAuth, so it can only read the projects, scenarios, and runs you already have access to.

MCP server URL

Paste this URL into your assistant’s custom MCP connector settings.

https://assertive.tech/mcp

If OAuth registration fails in your AI assistant, select “API Key Authentication” or add header Authorization: Bearer <YOUR_ASSERTIVE_API_KEY>. Create a key in Settings → Security → MCP API keys (you can also send it as X-Assertive-Key).

How to connect

Connect with ChatGPT

  1. 1Open ChatGPT Connectors settings and enable Developer mode if it is not already on.
  2. 2Start a new custom connector from the New plugin dialog.
  3. 3Name the connector “Assertive” and paste the MCP URL above into the URL field.
  4. 4Review the details, check the confirmation, then create the connector. ChatGPT will ask you to sign in to Assertive so it can act as you.
  5. 5Enable the connector in the chat composer, then ask ChatGPT to use Assertive.

Refresh after the app changes

Connected assistants cache the tool list. After Assertive ships a new version or adds tools, refresh the connector to pick up the latest capabilities.

ChatGPT

  1. Open ChatGPT’s app preferences and pick Assertive under Enabled apps.
  2. Next to “Information”, click Refresh.
  3. If the URL changed, paste the latest URL: https://assertive.tech/mcp
  4. Start a new chat and ask ChatGPT to use Assertive.

Claude

  1. Open the Connectors page and select the Assertive connector.
  2. Refresh or update the connector’s tools.
  3. If the URL changed, paste the latest URL: https://assertive.tech/mcp
  4. Ask Claude to use Assertive.

Claude Code

  1. Start a new Claude Code session — it loads the latest tools on connect.
  2. If the URL changed, run claude mcp remove assertive, then re-run the install command.
  3. Ask Claude Code to use Assertive.

Other MCP clients

  1. Open the client’s MCP server or connector settings.
  2. Select the Assertive connection.
  3. Refresh the tool list, reload the server, or reconnect it.
  4. If the URL changed, paste the latest URL: https://assertive.tech/mcp
  5. Start a new chat or session and ask the assistant to use Assertive.

Connection troubleshooting

If your assistant reports something like “Couldn’t register with assertive’s sign-in service”, work through these steps in order.

  1. Check the URL is exactly https://assertive.tech/mcp — no trailing slash, no /sse suffix, and https.
  2. Remove the Assertive connector from your assistant and add it again — a half-finished registration is cached until you do.
  3. When the assertive.tech sign-in screen appears, sign in and approve the connection. If a pop-up blocker or a private window swallows it, retry in a normal browser window.
  4. If you are signed into more than one account, sign out of the others first so approval lands on the right workspace.
  5. After a major Assertive release, remove and re-add the connector so it re-registers against the latest server.

Still stuck? Email support@assertive.tech with the assistant you are using and the exact error text.