Skip to main content

Connect an agent

Enable the server on the MCP tab, then copy the ready-made config for your client — the tab fills in the live port and token for you. The examples below use the default port 8765; replace the TOKEN placeholder with the value shown in the tab.

tip

The tab has a Client setup section with a copy button per client, so you rarely need to type any of this by hand.

Claude Code​

claude mcp add --transport http qttaskmanager http://127.0.0.1:8765/mcp \
  --header "Authorization: Bearer TOKEN"

GitHub Copilot​

VS Code reads MCP servers from .vscode/mcp.json under the servers key:

{
  "servers": {
    "qttaskmanager": {
      "type": "http",
      "url": "http://127.0.0.1:8765/mcp",
      "headers": { "Authorization": "Bearer TOKEN" }
    }
  }
}

OpenAI Codex​

~/.codex/config.toml — the token comes from an environment variable:

[mcp_servers.qttaskmanager]
url = "http://127.0.0.1:8765/mcp"
bearer_token_env_var = "QTM_MCP_TOKEN"

Then set QTM_MCP_TOKEN to the token before launching Codex.

Any other MCP client​

Point it at the Streamable HTTP endpoint http://127.0.0.1:8765/mcp and send the Authorization: Bearer TOKEN header. The tab also offers a generic mcpServers JSON block you can adapt.

After connecting​

  • Ask your agent to list the available tools — you should see the data, scan and operation tools.
  • Data and scan tools return immediately.
  • Operation tools (request_*) enqueue an approval that you resolve in the tab — see Human-in-the-loop.

Rotating the token​

Click Regenerate on the tab to issue a new token. Existing clients must be reconfigured with the new value; the old token stops working immediately.