Connect

NeetoAuth hosts the MCP server, so there is nothing to install or run locally. Add it to your assistant, sign in or supply an API key, then restart the assistant to make the NeetoAuth tools available.

Server details


Endpoint	`https://connect.neetoauth.com/mcp/messages`
Transport	HTTP
OAuth	Discovered from `https://connect.neetoauth.com/.well-known/oauth-authorization-server`
API key	`Authorization: Bearer <your-api-key>` header

Which method does your client use?

Read Authentication first: OAuth scopes the assistant to you, an API key scopes it to the whole workspace.

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

Clients that read a config file appear in both columns. Which method they use is decided by what you put in the file: include an Authorization header and it connects with the API key, leave it out and it starts the OAuth flow.

Connect with OAuth

Open Settings → Connectors → Add → Add custom connector, give it a name such as NeetoAuth, and paste:

https://connect.neetoauth.com/mcp/messages

Approve the connection when your browser opens. This works on claude.ai, the Claude desktop app, and Cowork.

Turn on Settings → Security and login → Developer mode, then open Plugins → Browse plugins → + → New Plugin and paste:

https://connect.neetoauth.com/mcp/messages

Approve the connection when your browser opens.

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

Then run /mcp inside Claude Code and choose to sign in. Omitting --header is what selects OAuth.

Add the server to ~/.codex/config.toml:

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

Then sign in:

codex mcp login neetoauth

Codex uses TOML, not JSON.

Create or edit ~/.cursor/mcp.json:

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

Restart Cursor, then approve the sign-in prompt.

Edit ~/.gemini/settings.json:

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

Gemini CLI uses httpUrl for streamable HTTP; url means SSE. The sign-in flow starts the first time the server answers with a 401.

Create .vscode/mcp.json in your workspace:

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

Requires VS Code 1.99 or later and GitHub Copilot Chat’s Agent mode. VS Code uses servers, not mcpServers.

Edit ~/.codeium/windsurf/mcp_config.json:

{
  "mcpServers": {
    "neetoauth": {
      "serverUrl": "https://connect.neetoauth.com/mcp/messages"
    }
  }
}

Windsurf uses serverUrl, not url. Enable the server in Settings → Cascade → MCP Servers.

Connect with an API key

Replace YOUR_API_KEY with your NeetoAuth API key. Remember that a key is scoped to the whole workspace, not to you.

Add the server to ~/.claude.json:

{
  "mcpServers": {
    "neetoauth": {
      "type": "http",
      "url": "https://connect.neetoauth.com/mcp/messages",
      "headers": {
        "Authorization": "Bearer YOUR_API_KEY"
      }
    }
  }
}

Save the file, then restart Claude Code.

Add the server to ~/.codex/config.toml:

[mcp_servers.neetoauth]
url = "https://connect.neetoauth.com/mcp/messages"
bearer_token_env_var = "NEETOAUTH_API_KEY"

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

Create or edit ~/.cursor/mcp.json:

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

Save the file, then restart Cursor or reload its window.

Edit ~/.gemini/settings.json:

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

Gemini CLI uses httpUrl, not url.

Create .vscode/mcp.json in your workspace:

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

This file lives in your repository. Do not commit it with a key in it - add it to .gitignore, or use OAuth instead.

Edit ~/.codeium/windsurf/mcp_config.json:

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

Windsurf uses serverUrl, not url, and allows up to 100 MCP tools across all connected servers.

Verify the connection

After your assistant reloads, confirm that the NeetoAuth tools are listed. Then try a prompt such as “Which neeto products are enabled in my NeetoAuth workspace?” Find more in Examples.

Getting Started

Reference

Server details

Which method does your client use?

Connect with OAuth

Connect with an API key

Verify the connection

​Server details

​Which method does your client use?

​Connect with OAuth

​Connect with an API key

​Verify the connection

Server details

Which method does your client use?

Connect with OAuth

Connect with an API key

Verify the connection