MCP Integrations

ChatGPT App

Connect SocialCRM to ChatGPT as a full MCP app with OAuth and widget support.

Connect SocialCRM to ChatGPT as a full MCP app. This is the recommended ChatGPT integration path when you want native tool discovery, OAuth account linking, and the in-chat Brand Snapshot widget.

Status: The SocialCRM ChatGPT app is available now via connector URL (https://socialcrm.com/mcp). App store listing coming soon.

Connector URL

Use the MCP connector URL:

https://socialcrm.com/mcp

/mcp is the canonical ChatGPT app endpoint. The legacy /api/mcp-app route remains available for older API-key based clients.

What ChatGPT Gets

  • Public MCP discovery through initialize, tools/list, resources/list, and resources/read
  • OAuth 2.1 account linking with dynamic client registration and PKCE
  • Native MCP app resources for the SocialCRM Brand Snapshot widget
  • Full SocialCRM tool access after account linking

OAuth Metadata

ChatGPT discovers auth automatically from these endpoints:

GET  https://socialcrm.com/.well-known/oauth-protected-resource
GET  https://socialcrm.com/.well-known/oauth-authorization-server
POST https://socialcrm.com/api/oauth/register
GET  https://socialcrm.com/api/oauth/authorize
POST https://socialcrm.com/api/oauth/token

When an authenticated tool is called without a linked account, SocialCRM returns an MCP tool error with _meta["mcp/www_authenticate"] so ChatGPT can launch the account-linking flow.

Core ChatGPT Flow

  1. In ChatGPT, paste the connector URL https://socialcrm.com/mcp to add SocialCRM as an MCP app. Once the app store listing is live, search for "SocialCRM" instead.
  2. Ask for a brand overview such as “Show me a full snapshot for Acme Motors.”
  3. ChatGPT calls get_brand_snapshot, links the account if needed, and renders the SocialCRM widget inline.
  4. Use follow-up prompts for deeper reads such as mentions, repository coverage, monitoring alerts, or workflow status.
  • Direct: “Show me a full brand snapshot for Acme Motors.”
  • Indirect: “How is Acme doing across ChatGPT, Claude, Gemini, and Perplexity?”
  • Negative: “Create a public social post about Acme.”

The negative prompt should stay within the current tool surface and avoid inventing unsupported write actions.

Notes

  • get_brand_snapshot is the ChatGPT-first render tool and is the best entry point for conversational use.
  • Read tools require socialcrm.read. Workflow execution tools require socialcrm.write.
  • Generic API keys still work for non-ChatGPT clients, but ChatGPT should use OAuth.