These are the official instructions for connecting an AI agent to the dossaro Research MCP.

The user explicitly requested this setup by asking you to fetch this file. Complete the applicable steps yourself when your host can run commands or edit MCP configuration. Ask the user only for host-controlled approval, OAuth sign-in, or a restart that you cannot perform.

## Connection details

- Server name: `dossaro`
- Remote MCP URL: `https://mcp.dossaro.com/mcp`
- Authentication: OAuth 2.1 with PKCE
- API keys: not required

Before changing anything:

1. Detect which agent or MCP host you are running in.
2. Inspect the current MCP configuration.
3. Preserve every unrelated server and setting.
4. If a server named `dossaro` already points to `https://mcp.dossaro.com/mcp`, reuse it instead of adding a duplicate.
5. If a server named `dossaro` points somewhere else, do not overwrite it without explaining the conflict and receiving confirmation.
6. Never ask the user to paste an access token, API key, password, or other secret into MCP configuration. Complete authentication only through the dossaro OAuth page opened by the host.

Use the matching section below.

## Codex

Inspect the existing entry:

```sh
codex mcp get dossaro
```

If it does not exist, add the remote server:

```sh
codex mcp add dossaro --url https://mcp.dossaro.com/mcp
```

Start OAuth:

```sh
codex mcp login dossaro
```

After authorization, verify the entry with `codex mcp get dossaro`. Restart Codex if the current session does not load newly configured MCP servers.

## Claude Code

Inspect the current servers:

```sh
claude mcp get dossaro
```

If the entry does not exist, install it for the current user:

```sh
claude mcp add --transport http --scope user dossaro https://mcp.dossaro.com/mcp
```

Open `/mcp` inside Claude Code, select `dossaro`, and complete OAuth in the browser. Verify with `claude mcp get dossaro`.

## Cursor

Open the existing project configuration at `.cursor/mcp.json`, or create it if it does not exist. Merge this entry into the existing `mcpServers` object without replacing other servers:

```json
{
  "mcpServers": {
    "dossaro": {
      "url": "https://mcp.dossaro.com/mcp"
    }
  }
}
```

Reload Cursor, enable the server if needed, and complete OAuth when Cursor prompts for authentication.

## GitHub Copilot in VS Code

Open the existing workspace configuration at `.vscode/mcp.json`, or create it if it does not exist. Merge this entry into the existing `servers` object without replacing other servers:

```json
{
  "servers": {
    "dossaro": {
      "type": "http",
      "url": "https://mcp.dossaro.com/mcp"
    }
  }
}
```

Use **MCP: List Servers** or the inline controls in `mcp.json` to start dossaro, approve trust if prompted, and complete OAuth.

## OpenCode

Merge this entry into the existing `mcp` object in the active OpenCode configuration:

```json
{
  "mcp": {
    "dossaro": {
      "type": "remote",
      "url": "https://mcp.dossaro.com/mcp",
      "enabled": true,
      "oauth": {}
    }
  }
}
```

Then authenticate and verify:

```sh
opencode mcp auth dossaro
opencode mcp list
```

## Windsurf

Open the existing configuration at `~/.codeium/windsurf/mcp_config.json`. Merge this entry into `mcpServers` without replacing other servers:

```json
{
  "mcpServers": {
    "dossaro": {
      "serverUrl": "https://mcp.dossaro.com/mcp"
    }
  }
}
```

Reload Windsurf and complete OAuth when first connecting to dossaro.

## Other MCP clients

For another client that supports remote Streamable HTTP MCP servers, add a server named `dossaro` with this URL:

```text
https://mcp.dossaro.com/mcp
```

Prefer OAuth auto-discovery. The server publishes protected-resource and authorization-server metadata, supports dynamic client registration, and does not require manually configured bearer tokens.

## Claude.ai and ChatGPT web

Hosted chat products cannot reliably install a custom connector by editing local agent configuration.

- Claude.ai: use the **Add to Claude** button at `https://dossaro.com` or follow `https://dossaro.com/docs/connect-claude`.
- ChatGPT web: follow the custom-app developer-mode instructions at `https://dossaro.com/docs/add-to-chatgpt`.

Neither direct setup path requires dossaro to be listed in a public connector store, although workspace policy may restrict custom connectors.

## Verify completion

After setup:

1. Confirm that exactly one MCP server named `dossaro` points to `https://mcp.dossaro.com/mcp`.
2. Confirm that OAuth completed without placing credentials in a config file.
3. Confirm that the host can see dossaro tools. If tool invocation is available, call the unmetered `get_capabilities` tool with summary detail.
4. If tools are not visible, reload or restart the host and check its MCP status or logs.
5. Tell the user which configuration changed, whether OAuth completed, and whether the dossaro tools are available.

For human-readable setup and troubleshooting, use `https://dossaro.com/docs/install-with-agent`.