This is not a public marketplace connector yet
The MCP endpoint and OAuth flow are guarded by a global rollout switch and a workspace entitlement. Claude distribution, public OpenAI installation, and self-service connection management remain unavailable.
Step 1
Before you start
- Your NoClutterCRM workspace must have approved MCP beta access.
- You need an active NoClutterCRM user account with access to at least one brand.
- Your client must support remote MCP over Streamable HTTP and OAuth login.
- Use only the production endpoint below. Never paste a bearer token into a plugin or configuration file.
https://nocluttercrm.com/mcp/nocluttercrm
Step 2A
Connect with Codex
Desktop app or IDE extension
- Open Settings → MCP servers.
- Choose Add server, select Streamable HTTP, and enter the endpoint above.
- Name the server NoClutterCRM, save it, and restart the client when prompted.
- Select Authenticate and complete the NoClutterCRM browser flow.
Codex CLI
Add this server to ~/.codex/config.toml or a trusted project’s .codex/config.toml:
[mcp_servers.nocluttercrm]
url = "https://nocluttercrm.com/mcp/nocluttercrm"
auth = "oauth"
Then start OAuth login:
codex mcp login nocluttercrm
See the official Codex MCP guide for the current client controls.
Step 2B
Connect with ChatGPT
NoClutterCRM is not listed in the public Plugins Directory. Approved testers can add the remote server through ChatGPT developer mode when that feature is available to their account and workspace:
- Open ChatGPT settings, select Security and login, and enable Developer mode.
- Open Plugins, choose the add button, and create a connection using the endpoint above.
- Review the tools ChatGPT discovers, then complete NoClutterCRM authentication.
Workspace policy can hide developer mode or prevent private connections. See OpenAI’s current connection guide.
Step 2C
Other MCP clients
A compatible client must support the MCP 2025-11-25 Streamable HTTP transport, OAuth Authorization Code with PKCE, protected-resource discovery, and dynamic public-client registration. Approval is case by case during the beta.
Claude is not currently a supported production connection
Claude and Claude Code distribution remains planned while protocol, OAuth audience, connection-management, and live interoperability work is completed. Do not treat generic MCP support as NoClutterCRM approval.
Step 3
Approve the connection carefully
- Sign in to NoClutterCRM and complete recent password or passkey confirmation.
- Confirm that the displayed NoClutterCRM user and workspace are correct.
- Check the full redirect destination and confirm that you initiated the connection.
- Read the data-egress notice: CRM results can be processed by the client’s AI provider under your agreement with that provider.
- Choose Connect only when every detail is expected.
A dynamically registered client is labelled Unverified public client. Its self-supplied name is not publisher verification.
Step 4
Verify with a read before a write
Start with prompts that prove brand and record visibility without changing anything:
“List the NoClutterCRM brands I can access.”
“Find Acme and summarize its open deals and tasks. Do not change anything.”
“Show the current state of contact jane@example.com before proposing an update.”
For a write, ask the assistant to summarize the exact proposed change first. After saving, verify the returned record ID and state in NoClutterCRM.
Disconnect
Remove access from the client
Use the client’s Disconnect, Remove, or Logout action first. Clients that support token revocation can revoke the current server token as part of that flow.
Workspace connection management is still planned
Until NoClutterCRM has an owner-visible connection page, contact support@nocluttercrm.com when you need server-side help reviewing or revoking a connection. Access tokens expire after 60 minutes; refresh access can last up to 30 days unless revoked or disabled.
Troubleshooting
Common beta blockers
- The endpoint returns “not found”
- The global connector beta may be disabled. Confirm the rollout status with NoClutterCRM support.
- Authorization says the workspace is unavailable
- The workspace may be inactive or may not have the MCP entitlement. An owner should contact support.
- A record is missing or a write is forbidden
- NoClutterCRM rechecks your live brand membership and role permissions on every tool call. Verify the selected brand and your access in the CRM.
- The OAuth callback or client is rejected
- Only reviewed HTTPS origins and approved local loopback callbacks are allowed. Send the client name, version, and safe callback origin—not a token—to support.
Need help with a beta connection?
Tell us which client and version you use, whether the workspace is already approved, and the step that failed. Never email an access token, authorization header, or client secret.
Email connector support