Connect

Server details


Server URL	`https://connect.neetodesk.com/mcp/messages`
Workspace URL	`https://<your-subdomain>.neetodesk.com/mcp/messages`
Transport	Streamable HTTP
Credential	`Authorization: Bearer <token>`, an OAuth token or an API key

Use the server URL for OAuth and let the browser flow pick the workspace. Use the workspace URL with an API key, since the subdomain already names the workspace. See Authentication for the difference.

Which method each client supports

Client	OAuth	API key
Claude	Yes	No
ChatGPT	Yes	No
Claude Code	Yes	Yes
Codex	Yes	Yes
Cursor	Yes	Yes
Gemini CLI	Yes	Yes
VS Code	Yes	Yes
Windsurf	No	Yes

Clients that read a config file appear in both lists below. Which method they use is decided by whether you put a credential in the file: leave the header out and the client runs the OAuth flow on its first 401.

OAuth

Go to Settings → Connectors → Add → Add custom connector, give it a name, paste https://connect.neetodesk.com/mcp/messages and save. Claude opens NeetoDesk for you to approve the connection.This works on claude.ai, the Claude desktop app and Cowork.

Turn on Developer mode under Settings → Security and login, then go to Plugins → Browse plugins → + → New Plugin and paste https://connect.neetodesk.com/mcp/messages.

claude mcp add --transport http neetodesk https://connect.neetodesk.com/mcp/messages

Then run /mcp inside Claude Code and pick neetodesk to sign in. Leaving --header off is what selects OAuth.

Add to ~/.codex/config.toml:

[mcp_servers.neetodesk]
url = "https://connect.neetodesk.com/mcp/messages"

Then sign in:

codex mcp login neetodesk

Add to ~/.cursor/mcp.json:

{
  "mcpServers": {
    "neetodesk": {
      "url": "https://connect.neetodesk.com/mcp/messages"
    }
  }
}

Restart Cursor, or reload the window from the command palette. Cursor prompts you to sign in the first time it connects.

Add to ~/.gemini/settings.json:

{
  "mcpServers": {
    "neetodesk": {
      "httpUrl": "https://connect.neetodesk.com/mcp/messages"
    }
  }
}

The key is httpUrl. Using url selects SSE, which this server does not serve. The sign-in flow starts when the server first answers with a 401.

Add to .vscode/mcp.json:

{
  "servers": {
    "neetodesk": {
      "type": "http",
      "url": "https://connect.neetodesk.com/mcp/messages"
    }
  }
}

Needs VS Code 1.99 or newer, with Copilot chat in Agent mode.

API key

Generate a key from your workspace admin panel first. See the API keys help article. Replace YOUR_SUBDOMAIN with your workspace subdomain and YOUR_API_KEY with the key.

claude mcp add --transport http neetodesk \
  https://YOUR_SUBDOMAIN.neetodesk.com/mcp/messages \
  --header "Authorization: Bearer YOUR_API_KEY"

Add to ~/.codex/config.toml:

[mcp_servers.neetodesk]
url = "https://YOUR_SUBDOMAIN.neetodesk.com/mcp/messages"
bearer_token_env_var = "NEETODESK_API_KEY"

bearer_token_env_var takes the name of an environment variable, not the key itself. Export the key under that name before starting Codex.

Add to ~/.cursor/mcp.json:

{
  "mcpServers": {
    "neetodesk": {
      "url": "https://YOUR_SUBDOMAIN.neetodesk.com/mcp/messages",
      "headers": {
        "Authorization": "Bearer YOUR_API_KEY"
      }
    }
  }
}

Add to ~/.gemini/settings.json:

{
  "mcpServers": {
    "neetodesk": {
      "httpUrl": "https://YOUR_SUBDOMAIN.neetodesk.com/mcp/messages",
      "headers": {
        "Authorization": "Bearer YOUR_API_KEY"
      }
    }
  }
}

Add to .vscode/mcp.json:

{
  "servers": {
    "neetodesk": {
      "type": "http",
      "url": "https://YOUR_SUBDOMAIN.neetodesk.com/mcp/messages",
      "headers": {
        "Authorization": "Bearer YOUR_API_KEY"
      }
    }
  }
}

.vscode/mcp.json lives in the repository, so a key pasted here is easy to commit by accident and would then be readable by everyone with repository access.Prefer the OAuth tab above for this client, which stores no credential in the repository at all. If you do use a key, ignore the file before you paste it in:

echo ".vscode/mcp.json" >> .gitignore

Anyone who has already committed a key should treat it as disclosed and revoke it from the workspace admin panel, since rewriting history does not remove it from clones.

Add to ~/.codeium/windsurf/mcp_config.json:

{
  "mcpServers": {
    "neetodesk": {
      "serverUrl": "https://YOUR_SUBDOMAIN.neetodesk.com/mcp/messages",
      "headers": {
        "Authorization": "Bearer YOUR_API_KEY"
      }
    }
  }
}

The key is serverUrl, not url. Then turn the connection on under Settings → Cascade → MCP Servers. Windsurf caps you at 100 tools across every connected server, so turn a few others off if it complains.

Next steps

Examples

Prompts to try now that you are connected.

Getting Started

Reference

Server details

Which method each client supports

OAuth

API key

Next steps

Examples

​Server details

​Which method each client supports

​OAuth

​API key

​Next steps

Examples

Server details

Which method each client supports

OAuth

API key

Next steps