Connect an AI client over MCP.
AgentTask is a remote MCP server: one HTTPS endpoint, no local install. Point Claude Code, Claude Desktop, GitHub Copilot, Gemini, Cursor, Codex, Windsurf and Zed or any MCP client at it and read and write the same backlog from a conversation.
Endpoint
Streamable HTTP over POST. Not stdio, not legacy SSE.
https://app.agent-task.com/v1/public/mcpAuthentication
OAuth 2.1 (browser sign-in)
Add the URL and your client opens the browser. Approve the spaces it may reach; the token belongs to you, is confined to those spaces, and can be revoked. Clients discover the sign-in endpoints from /.well-known/oauth-protected-resource, register themselves, and use PKCE. No key to copy.
API key
For clients without sign-in support, and for scripts. Create an organization key in the app (Settings → API keys; members need an admin to enable self-service keys or grant “Manage API keys”), grant it only the scopes you need, and send it on every request:
Authorization: Bearer amk_YOUR_KEYBoth work on the same endpoint. Requests are rate limited per key; on a 429, honor Retry-After. See the API reference for the numbers.
Pick your client
Setup below was checked against each vendor’s documentation (latest check 2026-10-08). Vendors rename menus and flags often; each block links its source.
Claude Code · Terminal
Plugin
Browser sign-in (OAuth)The connection plus slash commands and workflow skills. Signs in through the browser.
Install the plugin
Typed inside Claude Code. If the install summary asks, run /reload-plugins.
text/plugin marketplace add AgentTaskLLC/AgentTask-plugin /plugin install agent-task@agent-taskPoint it at this workspace
The plugin bundles the production endpoint. If the endpoint above is different, export AGENT_TASK_MCP_URL in the shell that starts Claude Code.
shellexport AGENT_TASK_MCP_URL="https://app.agent-task.com/v1/public/mcp"claude mcp list prints the resolved URL next to plugin:agent-task:agent-task.
Sign in
Run /mcp, pick agent-task, and approve the spaces it may reach when the browser opens.
Checked 2026-10-08 against Claude Code docs (MCP, Discover plugins, Plugins reference) + Claude Code 2.1.238 --plugin-dir probe of ${VAR:-default} expansion · vendor docs (opens in a new tab)
MCP only
API keyTools only, no slash commands. Uses an API key.
Add the server
shellclaude mcp add --transport http agent-task https://app.agent-task.com/v1/public/mcp --header "Authorization: Bearer amk_YOUR_KEY"Add --scope user to make it available in every project.
Or commit a project file that reads the key from your environment
json{ "mcpServers": { "agent-task": { "type": "http", "url": "https://app.agent-task.com/v1/public/mcp", "headers": { "Authorization": "Bearer ${AGENT_TASK_API_KEY}" } } } }Check it
Run /mcp inside Claude Code, or claude mcp list; agent-task should show ✔ Connected.
Checked 2026-10-08 against Claude Code docs — Connect Claude Code to tools via MCP · vendor docs (opens in a new tab)
Claude Desktop · Desktop app · claude.ai
Custom connector
Browser sign-in (OAuth)A custom connector that signs in through the browser. No key needed.
Add a custom connector
Customize → Connectors → + → Add custom connector, and paste the endpoint. Same path in Claude Desktop and on claude.ai.
texthttps://app.agent-task.com/v1/public/mcpTeam and Enterprise: an Owner adds it under Organization settings → Connectors (Custom → Web); members then click Connect. Free plans get one custom connector.
Sign in
Approve the spaces the connector may reach when the browser opens.
Checked 2026-10-08 against Claude Help Center — Getting started with custom connectors using remote MCP · vendor docs (opens in a new tab)
GitHub Copilot · VS Code · CLI · GitHub
VS Code
API keyCopilot Chat in agent mode, through .vscode/mcp.json or the user configuration.
Add the server
Create .vscode/mcp.json, or run "MCP: Open User Configuration" from the Command Palette. VS Code asks for the key once when the server starts and stores it.
json{ "inputs": [ { "type": "promptString", "id": "agent-task-key", "description": "Agent Task API key (amk_…)", "password": true } ], "servers": { "agent-task": { "type": "http", "url": "https://app.agent-task.com/v1/public/mcp", "headers": { "Authorization": "Bearer ${input:agent-task-key}" } } } }Watch out: The key is "servers" here and "mcpServers" on github.com.
Start it
Run "MCP: List Servers", pick agent-task and start it; paste the key at the prompt.
Checked 2026-10-08 against VS Code docs — Use MCP servers in VS Code + MCP configuration reference · vendor docs (opens in a new tab)
CLI
API keyCopilot CLI in the terminal.
Add the server
shellcopilot mcp add --transport http agent-task https://app.agent-task.com/v1/public/mcp --header "Authorization: Bearer amk_YOUR_KEY"Writes ~/.copilot/mcp-config.json (mcpServers, type "http", url, headers, tools ["*"]). Inside the CLI, /mcp add opens the same form.
Checked 2026-10-08 against GitHub Docs — Adding MCP servers for GitHub Copilot CLI · vendor docs (opens in a new tab)
Cloud agent
API keyThe Copilot cloud agent (formerly coding agent) on github.com, configured per repository.
Store the key as an Agents secret
Repository → Settings → Secrets and variables → Agents → Secrets → New repository secret, named COPILOT_MCP_AGENT_TASK_KEY.
Only secrets prefixed COPILOT_MCP_ reach MCP servers.
Add the server to the repository
Repository → Settings → Copilot → MCP servers → MCP configuration, then Save MCP configuration.
json{ "mcpServers": { "agent-task": { "type": "http", "url": "https://app.agent-task.com/v1/public/mcp", "tools": ["*"], "headers": { "Authorization": "Bearer $COPILOT_MCP_AGENT_TASK_KEY" } } } }Watch out: "type", "url" and "tools" are all required here; ["*"] enables every tool.
The cloud agent does not support OAuth remote servers, so a key is the only option.
Checked 2026-10-08 against GitHub Docs — Configure MCP servers for your repository (Copilot cloud agent) · vendor docs (opens in a new tab)
Gemini · CLI · App
CLI
API keyGemini CLI, any tier.
Add the server
shellgemini mcp add --transport http --header "Authorization: Bearer amk_YOUR_KEY" agent-task https://app.agent-task.com/v1/public/mcpWrites an httpUrl entry into settings.json; --scope user makes it global. Check with /mcp inside Gemini CLI.
Checked 2026-10-08 against Gemini CLI docs — MCP servers with the Gemini CLI · vendor docs (opens in a new tab)
Gemini app
Browser sign-in (OAuth)A custom app in Gemini Spark. Signs in through the browser.
Add a custom app
gemini.google.com → Settings & help → Connected apps → Custom apps for Spark → Add a custom app, and paste the endpoint.
texthttps://app.agent-task.com/v1/public/mcpLimited rollout: needs Gemini Spark access on a personal Google Account (no work or school accounts), 18+, US, English, and Keep Activity on.
Checked 2026-10-08 against Gemini Apps Help — Connect & manage custom apps for Gemini Spark in the Gemini web app · vendor docs (opens in a new tab)
Cursor · Editor
Sign in
Browser sign-in (OAuth)A URL-only entry; Cursor opens the browser to sign in. No key needed.
Add the server
~/.cursor/mcp.json for every project, or .cursor/mcp.json for one.
json{ "mcpServers": { "agent-task": { "url": "https://app.agent-task.com/v1/public/mcp" } } }Sign in
Enable it under Customize in the sidebar; approve the spaces when the browser opens.
Checked 2026-10-08 against Cursor docs — Model Context Protocol (MCP), Authentication section · vendor docs (opens in a new tab)
API key
API keyThe same file with a bearer key instead of a sign-in.
Add the server
~/.cursor/mcp.json for every project, or .cursor/mcp.json for one. No "type" key is needed.
json{ "mcpServers": { "agent-task": { "url": "https://app.agent-task.com/v1/public/mcp", "headers": { "Authorization": "Bearer amk_YOUR_KEY" } } } }To keep the key out of the file, write "Bearer ${env:AGENT_TASK_API_KEY}" and export the variable.
Enable it
Customize in the sidebar lists the server; toggle it on if needed.
Checked 2026-10-08 against Cursor docs — Model Context Protocol (MCP) · vendor docs (opens in a new tab)
Codex · App · CLI · IDE
API key
API keyCodex CLI, app and IDE extension share ~/.codex/config.toml.
Add the server
shellcodex mcp add agent_task --url https://app.agent-task.com/v1/public/mcp --bearer-token-env-var AGENT_TASK_API_KEYExport AGENT_TASK_API_KEY in the shell that starts Codex.
Or write the entry yourself
toml[mcp_servers.agent_task] url = "https://app.agent-task.com/v1/public/mcp" bearer_token_env_var = "AGENT_TASK_API_KEY"
Checked 2026-10-08 against Codex docs — Model Context Protocol (CLI surface) · vendor docs (opens in a new tab)
Sign in
Browser sign-in (OAuth)A URL-only entry plus codex mcp login. No key needed.
Add the server and sign in
shellcodex mcp add agent_task --url https://app.agent-task.com/v1/public/mcp codex mcp login agent_taskApprove the spaces Codex may reach when the browser opens.
Checked 2026-10-08 against Codex docs — Model Context Protocol (CLI surface) · vendor docs (opens in a new tab)
Windsurf · Editor
mcp_config.json
API keyCascade's MCP configuration file, ~/.codeium/windsurf/mcp_config.json.
Add the server
Edit the file directly, or open it from the MCPs icon in Cascade.
json{ "mcpServers": { "agent-task": { "serverUrl": "https://app.agent-task.com/v1/public/mcp", "headers": { "Authorization": "Bearer amk_YOUR_KEY" } } } }Remote servers take "serverUrl" (or "url"); streamable HTTP is supported.
Checked 2026-10-08 against Windsurf / Devin Desktop docs — Cascade MCP · vendor docs (opens in a new tab)
Zed · Editor
API key
API keyA remote context server in Zed settings.
Add the context server
In settings.json (zed: open settings).
json{ "context_servers": { "agent-task": { "url": "https://app.agent-task.com/v1/public/mcp", "headers": { "Authorization": "Bearer amk_YOUR_KEY" } } } }
Checked 2026-10-08 against Zed docs — Model Context Protocol · vendor docs (opens in a new tab)
Sign in
Browser sign-in (OAuth)The same entry without a header; Zed prompts you to sign in.
Add the context server
json{ "context_servers": { "agent-task": { "url": "https://app.agent-task.com/v1/public/mcp" } } }Sign in
Zed prompts to authenticate; approve the spaces when the browser opens.
Checked 2026-10-08 against Zed docs — Model Context Protocol · vendor docs (opens in a new tab)
Anything that speaks Streamable HTTP MCP and can send a bearer header can connect, such as ChatGPT and Cline. We have not individually verified those; use the generic setup and check it against that client’s own MCP documentation.
Any other MCP client · Manual setup
Any client
API keyStreamable HTTP with a bearer key. Not stdio, not legacy SSE.
Server configuration
json{ "mcpServers": { "agent-task": { "type": "http", "url": "https://app.agent-task.com/v1/public/mcp", "headers": { "Authorization": "Bearer amk_YOUR_KEY" } } } }Check it is reachable
shellcurl -i -X POST https://app.agent-task.com/v1/public/mcp \ -H "Authorization: Bearer amk_YOUR_KEY" \ -H "Content-Type: application/json" \ -H "Accept: application/json, text/event-stream" \ -d '{"jsonrpc":"2.0","id":1,"method":"initialize","params":{"protocolVersion":"2025-06-18","capabilities":{},"clientInfo":{"name":"curl","version":"0"}}}'A JSON result means the endpoint and key are good. A 401 means the key; anything else means the URL.
Checked 2026-10-08 against This server (be/services/api/src/routes/mcpServer.ts) + MCP specification 2025-06-18 (lifecycle, Streamable HTTP transport) · vendor docs (opens in a new tab)
Next
- MCP tool catalog — every tool, its scope, and whether it writes.
- REST API reference — the same workspace over plain HTTP.
- Claude integration — the plugin and slash commands.