MCP OAuth Connect
Ping-only MCP origin for claude.ai, Desktop, Cursor, and Grok Connectors.
Install
Add this to your client's MCP configuration (Claude Desktop: claude_desktop_config.json; Cursor: .cursor/mcp.json; VS Code and others use the same "mcpServers" shape).
claude mcp add --transport http mcp-oauth-connect 'https://mcp.gfbytes.com/mcp'
{
"mcpServers": {
"mcp-oauth-connect": {
"type": "http",
"url": "https://mcp.gfbytes.com/mcp"
}
}
}
Documentation
From the project's README on GitHub, refreshed weekly. Links open on GitHub.
Contents
MCP OAuth Connect
Free checker for when an MCP remote answers curl but dies in Claude / Cursor / Desktop / Grok Connectors.
| Live checker | check.gfbytes.com |
| This repo | CLI diagnose.py + plugin / skill |
| Web UI | mcp-gfbytes |
| Demo MCP | https://mcp.gfbytes.com |
Part of GFB's lab surface. Founder / peer identity: gregfredabytes.com · essay · what I run
What this is not
- Not a hosted MCP product.
https://mcp.gfbytes.comis a ping-only reference server. - Not a completed handshake. The checker reads discovery metadata. It does not do DCR, mint a token, or call
tools/list. A fail is a scoping signal, not a dead end. - Not the paid attach lab. Four-client attempt + written path lives on the studio product page.
Paste only the URL in a Connectors UI — no API key.
Clone / run
Stdlib Python ≥3.10. No install for the checker:
git clone https://github.com/GFB2026/mcp-oauth-connect.git
cd mcp-oauth-connect
python skills/mcp-oauth-connect/scripts/diagnose.py https://mcp.gfbytes.com
Exit 0 if connector-critical checks pass; 1 otherwise. JSON report on stdout.
Looks for a proper login challenge (not a bare 200 from curl), a registration endpoint, PKCE S256, and RFC 9728 protected-resource metadata.
Tests:
python -m pip install "pytest>=8"
python -m pytest
For AI assistants / contributors
Edit lanes and hard stops: .github/copilot-instructions.md.
Verify with python -m pytest (install pytest>=8; this tree is flat — no pip install -e).
Plugin install (optional)
Claude Code:
/plugin marketplace add GFB2026/mcp-oauth-connect
/plugin install mcp-oauth-connect@mcp-oauth-connect
Grok Build:
grok plugin marketplace add GFB2026/mcp-oauth-connect
grok plugin install mcp-oauth-connect --trust
Then run the same diagnose.py path as above.
template/
Public ping-only example behind https://mcp.gfbytes.com (MIT). Reference server, not a service SKU.
License
MIT for the plugin, skill, diagnose script, tests, and template/. Studio attach-lab / fix-round services are separate offers on gfbytes.com.
Frequently asked questions
What is MCP OAuth Connect?
Ping-only MCP origin for claude.ai, Desktop, Cursor, and Grok Connectors.
How do I install MCP OAuth Connect?
It runs as a remote server. In Claude Code: claude mcp add --transport http mcp-oauth-connect 'https://mcp.gfbytes.com/mcp'. For other clients, paste the JSON configuration from this page into their MCP settings.
Does MCP OAuth Connect need an API key?
Its registry entry lists no required key or secret. Some features may still need an account with the service it connects to.
Is MCP OAuth Connect open source?
Yes. Its code is on GitHub under the MIT license.
Who maintains MCP OAuth Connect?
It is published by GFB2026. AI.tn lists it but does not maintain or endorse it.
From the official MCP Registry. Listing is not an endorsement: review a server's code and permissions before giving it access to your data.