> ## Documentation Index
> Fetch the complete documentation index at: https://docs.socialglass.ai/llms.txt
> Use this file to discover all available pages before exploring further.

# MCP Connection

> Connect an MCP client directly to Social Glass.

# MCP Connection

The [Social Glass plugin](/reference/plugins) is the recommended setup for Codex and Claude Code. It installs the MCP connection and workflow skills together.

Use a direct MCP connection when your agent does not support the plugin or you only want the tools.

Do not add the standalone connection if the Social Glass plugin is already installed in the same agent. The plugin already provides this MCP server.

## Endpoint

```text theme={null}
https://mcp.socialglass.ai/mcp
```

Sign in with your Social Glass account when prompted. Test the connection with `get_context`.

## Codex

```bash theme={null}
codex mcp add social-glass --url https://mcp.socialglass.ai/mcp
codex mcp login social-glass --scopes profile,email
```

## Claude Code

```bash theme={null}
claude mcp add --transport http social-glass https://mcp.socialglass.ai/mcp
```

Start Claude Code and use `/mcp` to finish signing in.

## Other MCP clients

Add the endpoint as a remote HTTP MCP server and complete the OAuth flow. Eligible Social Glass users receive read access; write tools are available only to Social Glass admins.

## API keys

OAuth is preferred. If your client cannot retain OAuth sessions and your workspace has Clerk user API keys enabled, create a key with the `social-glass:mcp` scope and use it as the bearer token.

## Troubleshooting

* **Unauthorized:** reconnect and finish signing in.
* **Forbidden:** confirm that your account can access the selected organization. Write tools also require an admin account.
* **No authorization support:** confirm the client is using the endpoint above rather than an old or local URL.
* **Duplicate Social Glass server:** choose either the plugin or the standalone connection. To keep the plugin, remove only the manually added `social-glass` MCP entry, then start a new session. Check its source or scope before removing it; do not delete the plugin-provided server.

For native workflow guidance alongside the MCP, install the [plugin](/reference/plugins) or the [skills-only package](/reference/skills).