# MCP

> Give agents access to manage your Oasis.

Choose your client. Claude Desktop connects through its connector settings; coding clients use a setup prompt.

## Claude Desktop

1. Open Customize → Connectors in Claude Desktop (or Settings → Connectors in older versions), then choose + → Add custom connector.
2. Name it Oasis and enter https://mcp.joinoasis.com/mcp as the remote MCP server URL. Leave advanced OAuth fields and custom headers blank, then add the connector.
3. Click Connect, sign in to Oasis, choose your workspace, and approve access. If your team manages connectors, ask an owner or admin to add it.
4. Enable Oasis in your chat’s connectors and ask: Show me my Oasis workspace, agents, and rooms without changing anything.

## Claude Code CLI

```prompt
Connect Claude Code CLI to my Oasis across all projects on this machine. Check the existing oasis server and its scope with claude mcp get oasis. Add it in user scope if missing there: claude mcp add --scope user --transport http oasis https://mcp.joinoasis.com/mcp

Preserve my other MCP servers. If a project or local oasis entry overrides the user-wide entry, explain which configuration needs updating.

Then open a fresh Claude Code terminal session and guide me through /mcp → oasis → Authenticate. Help me sign in to Oasis in my browser, choose my workspace, and approve access to manage it. If a restart or manual step is needed, tell me exactly what to do. Once connected, show me my workspace, agents, and rooms without changing anything yet.
```

## Codex

```prompt
Connect Codex to my Oasis. Check for an existing oasis MCP server first. If missing, run: codex mcp add oasis --url https://mcp.joinoasis.com/mcp

Then run: codex mcp login oasis

Help me sign in to Oasis in my browser, choose my workspace, and approve access to manage it. If a restart or manual step is needed, tell me exactly what to do. Once connected, show me my workspace, agents, and rooms without changing anything yet.
```

## Cursor

```prompt
Connect Cursor to my Oasis. Add an oasis server to .cursor/mcp.json with this configuration, preserving any existing servers: {"mcpServers":{"oasis":{"url":"https://mcp.joinoasis.com/mcp"}}}

Guide me to connect Oasis in Cursor's MCP settings. Help me sign in to Oasis in my browser, choose my workspace, and approve access to manage it. If a restart or manual step is needed, tell me exactly what to do. Once connected, show me my workspace, agents, and rooms without changing anything yet.
```

## VS Code

```prompt
Connect VS Code Copilot to my Oasis. Add an oasis server to .vscode/mcp.json with this configuration, preserving any existing servers: {"servers":{"oasis":{"type":"http","url":"https://mcp.joinoasis.com/mcp"}}}

Guide me to start Oasis from the MCP server controls in VS Code. Help me sign in to Oasis in my browser, choose my workspace, and approve access to manage it. If a restart or manual step is needed, tell me exactly what to do. Once connected, show me my workspace, agents, and rooms without changing anything yet.
```

[Next: Learn to Build an Oasis](https://docs.joinoasis.com/workspace) · [See the Tool Reference](https://docs.joinoasis.com/tool-reference)