Skip to main content
In short: add https://mcp.socialglass.ai/mcp to your assistant as a custom connector, then sign in with your SocialGlass account. On a company plan (Claude Team or Enterprise, ChatGPT Business, Enterprise, or Edu), only a workspace admin can add it. The admin adds it once for everyone, then each person clicks Connect and signs in with their own SocialGlass account.
Want your assistant to walk you through it? Paste this into Claude or ChatGPT: “Help me connect SocialGlass to this app. Follow https://docs.socialglass.ai/reference/mcp-setup and ask me which plan I’m on.”

What you need

  • A SocialGlass account. Use the email address your SocialGlass contact invited.
  • The SocialGlass server URL:
  • On a company plan, a workspace admin. Forward them the admin steps for your app below.

Which steps to follow

If you can’t find Add custom connector in Claude or Add custom MCP server in ChatGPT, your workspace admin controls connectors. Send them this page.

Claude

These steps work on claude.ai. Connectors live in your Claude account, so once one is connected it also works in the Claude desktop and mobile apps.

Claude on a personal plan

For Free, Pro, and Max plans. The Free plan allows one custom connector.
  1. Open Customize > Connectors.
  2. Click + Add, then Add custom connector.
  3. Enter the name SocialGlass and the URL https://mcp.socialglass.ai/mcp. Click Continue.
  4. Keep the detected settings and click Continue.
  5. Choose these settings:
    • Authentication: Sign in now
    • OAuth client: Use Claude’s published identity (Recommended)
    • Request headers: leave empty
  6. Click Add, then sign in with your SocialGlass account and approve access.

Claude Team or Enterprise

Admin, once for the organization. On Team plans, only Owners and Primary Owners can add connectors. On Enterprise plans, so can people whose custom role includes managing the organization’s libraries.
  1. Open Organization settings > Connectors.
  2. Click Add, hover over Custom, and select Web.
  3. Enter the name SocialGlass and the URL https://mcp.socialglass.ai/mcp. Click Continue.
  4. Keep the detected settings and click Continue.
  5. Choose these settings:
    • Authentication: Sign in now, so each person signs in with their own SocialGlass account
    • OAuth client: Use Claude’s published identity (Recommended)
    • Request headers: leave empty
  6. Click Add.
Don’t put an API key or token in Request headers. Claude would share that one credential across the whole organization, so everyone would act as the same SocialGlass user. Claude can’t change these settings later: to fix them, remove the connector and add it again, and everyone reconnects. Each member, after the admin adds it:
  1. Open Customize > Connectors.
  2. Find SocialGlass. It may be labeled Custom.
  3. Click Connect and sign in with your SocialGlass account.

Use SocialGlass in a Claude chat

  1. In a chat, click + at the bottom left, then Connectors.
  2. Turn on SocialGlass.
  3. Ask something like “What can SocialGlass tell me about my Audience this week?”
Claude asks before it uses a tool for the first time. Choose Allow always for the tools you trust. You can turn individual tools off in the Search and tools menu.

ChatGPT

ChatGPT adds custom connectors on the web only, not in the mobile apps. ChatGPT renames these menus often; if a label below doesn’t match, see OpenAI’s custom MCP server guide.

ChatGPT Business, Enterprise, or Edu

Admin, once for the workspace. On Business, only admins and owners can add and publish connectors. On Enterprise and Edu, admins can also give selected members the Create plugins with MCPs permission, but only admins and owners can publish.
  1. In ChatGPT on the web, open Plugins.
  2. Select the + button, then Add custom MCP server.
  3. Enter the name SocialGlass. A description is optional.
  4. Under Connection, enter https://mcp.socialglass.ai/mcp.
  5. For authentication, choose OAuth. If ChatGPT asks how to register the client, choose CIMD.
  6. Review the risk warning and check I understand and want to continue.
  7. Select Create as a plugin, sign in with your SocialGlass account, and review the tools ChatGPT found.
  8. Test it: start a new chat, type @, select SocialGlass, and ask a question.
  9. Publish it for your workspace from the Admin console: select the workspace, open Plugins, then Manage Legacy Apps > Drafts > Publish. On Enterprise and Edu, use Configure Access to choose which groups get it.
Each member, after the admin publishes it: open Settings > Plugins, find SocialGlass, connect, and sign in with your own SocialGlass account.

ChatGPT Pro

Pro accounts can add SocialGlass for reading only: searching Posts, Creators, and Insights works, but actions that save something, such as submitting Posts or editing an Insight, don’t. Follow admin steps 1 to 8 above in your own account.

Use SocialGlass in a ChatGPT chat

Type @ in the message box and select SocialGlass. ChatGPT applies that choice to one message, so mention @SocialGlass again when a follow-up needs new data. ChatGPT asks you to confirm before actions that save something.

When SocialGlass adds or changes tools

ChatGPT keeps the tool list it saw when SocialGlass was added. When the changelog says to refresh the connector, an admin opens Workspace settings > Apps, selects ••• next to SocialGlass, and chooses Refresh. In a personal account, open Plugins, open SocialGlass, and select Refresh. Then start a new chat.

Claude Code and Codex

In Codex:
In Claude Code, run this, then use /mcp in Claude Code to sign in:

Other assistants

SocialGlass works with any assistant that supports remote MCP servers over HTTP with OAuth sign-in. SocialGlass only accepts sign-ins from assistants it has approved: today that’s Claude, Claude Code, ChatGPT, and Codex. If yours says the app isn’t allowed or registration was rejected, email team@socialglass.ai with the assistant’s name and we’ll check whether it can be approved. If your assistant can’t keep an OAuth sign-in and your workspace has user API keys turned on, create a key with the social-glass:mcp scope in your SocialGlass account settings and use it as the bearer token. Keep that key private. Never paste it into a chat, a shared connector, or a URL.

For AI assistants helping with setup

If you are an AI assistant helping someone connect SocialGlass, follow these steps:
  1. Ask which app they use (Claude, ChatGPT, Claude Code, Codex, or something else) and which plan. Plans decide whether they or a workspace admin adds the connector.
  2. Give the matching steps from this page word for word, including menu names. Don’t invent menu paths. If the app’s screens don’t match, point them to the vendor guide linked in that section.
  3. If they’re on a company plan and aren’t an admin, write a short message they can send their admin. Include the server URL, a link to this page, and the admin steps for their app.
  4. Never ask for passwords, tokens, or API keys. Sign-in happens in the browser window the app opens.
  5. Once connected, have them turn on SocialGlass in a chat. Then call get_context before any other SocialGlass tool. It returns their identity, organizations, Audiences, and working instructions.
Technical details: the server speaks MCP over streamable HTTP at https://mcp.socialglass.ai/mcp. Sign-in is OAuth with PKCE (S256), using Client ID Metadata Documents (CIMD) to identify approved clients. Dynamic Client Registration is turned off. The supported scopes are openid, profile, email, and offline_access. See the authentication guide for the full flow.

Troubleshooting

  • No option to add a connector: you’re on a company plan where an admin controls connectors. Send your admin this page.
  • Sign-in says the app isn’t allowed, or registration was rejected: your assistant isn’t approved for SocialGlass sign-in yet. Email team@socialglass.ai with the assistant’s name and the time it happened.
  • Unauthorized: reconnect and finish signing in.
  • Forbidden, or you can’t see your organization’s data: your SocialGlass account doesn’t have access to that organization. Ask your SocialGlass contact to add you. Signing in again won’t change this.
  • Can’t reach the server: check that the URL is exactly https://mcp.socialglass.ai/mcp, with no extra spaces or a missing /mcp.
  • Tools are missing or out of date: refresh the connector (ChatGPT) or disconnect and reconnect it (Claude), then start a new chat.
  • Invalid OAuth scope: request only openid, profile, email, and offline_access. If your assistant kept older settings, remove the connection and add it again.
  • Asked to sign in again repeatedly: reconnect. In Codex, restart the app if a task still uses an old sign-in. If it keeps happening, email us the approximate time and the error message. Don’t send tokens.
  • Duplicate SocialGlass tools in Claude Code or Codex: an older SocialGlass plugin may still be installed alongside the connection. Uninstall the plugin, keep the social-glass server, then start a new session.
Every SocialGlass user sees the same tools. What each tool can read or change depends on your role and the organizations you belong to.