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 through the connector URL below. 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 shown above 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.