MCP OAuth Connect

com.gfbytes由 gfbytes.com 发布官方发布者v0.2.0更新于 Oct 24, 2026

Ping-only MCP origin for claude.ai, Desktop, Cursor, and Grok Connectors.

已验证Streamable HTTP可网页运行开发者工具安全与监控

概览

AI 生成的概览

GFB 提供的远程、需 OAuth 认证的 ping-only MCP 参考端点，用于测试 MCP 客户端能否完成连接器握手。

可以做什么
将助手连接到固定远程地址上的 ping-only 参考 MCP 源，清单未列出工具，除基本 ping 式检查外没有声明的工具可调用。作为演示端点，供 claude.ai、Desktop、Cursor 和 Grok Connectors 在排查远程 MCP 能用 curl 访问却在客户端失败时使用。配合独立的 Python 标准库诊断脚本，读取发现元数据并报告登录质询、注册端点、PKCE S256 和保护资源元数据，以 0 或 1 退出并输出 JSON 报告。也可作为 Claude Code 或 Grok Build 插件安装，运行同一诊断流程。
适用场景
当你需要一个已知的 ping-only 远程 MCP 端点，用来测试客户端或连接器能否访问并认证远程 MCP 服务器时；或当远程 MCP 用 curl 正常但在 Claude、Cursor、Desktop 或 Grok Connectors 中失败、需要排查原因时。
运行要求
需要能通过网络访问提供商 MCP 主机的远程端点，且必须使用 OAuth 认证。诊断脚本需要 Python 3.10 或更高版本，仅用标准库；测试需要 pytest。未声明任何环境变量或请求头。
安装前请注意
该端点明确仅为 ping-only，不是托管的 MCP 产品，也不完成握手；检查器只读取发现元数据，不执行动态客户端注册、不签发令牌、不调用工具。检查失败被描述为范围信号，而非死路。README 提到工作室产品页上有单独的付费 attach lab，请勿将免费检查器与该付费服务混淆。

安装

在 SourceWeft 中

  1. 打开 控制台中的 MCP OAuth Connect，将其添加到工作区。
  2. 连接 所需的 凭据。它们会被私密存储，绝不会在公开页面上展示。
  3. 为需要使用其工具的对话启用该服务。

Web executable，通过 Streamable HTTP。 远程服务在工作区中配置后即可从网页运行时运行。

交给智能体安装

把这段提示词粘贴到 Claude Code、Codex、Cursor 等智能体，或 SourceWeft 对话中。智能体会读取该服务器的安装指南，先向你展示发布者、端点和登录方式，经你同意后再把它添加到你的客户端。密钥不会写进任何命令。

阅读 https://sourceweft.com/mcp/com.gfbytes%2Fmcp-oauth-connect/install.md，并按其中说明把这个 MCP 服务器接入我的客户端。修改任何配置之前，先告诉我它的发布者、端点和登录方式，等我确认。不要把 API 密钥写进命令或我会提交的文件；问我密钥应从哪里获取。

查看智能体所依据的安装指南

其他 MCP 客户端

把它添加到你客户端的 mcpServers 配置中。 客户端会在首次连接时完成 OAuth 登录。

{
  "mcpServers": {
    "oauth-connect": {
      "type": "http",
      "url": "https://mcp.gfbytes.com/mcp"
    }
  }
}

README

MCP OAuth Connect

[tests]

Free checker for when an MCP remote answers curl but dies in Claude / Cursor / Desktop / Grok Connectors.

Live checkercheck.gfbytes.com
This repoCLI diagnose.py + plugin / skill
Web UImcp-gfbytes
Demo MCPhttps://mcp.gfbytes.com

Part of GFB's lab surface. Founder / peer identity: gregfredabytes.com · essay · what I run

[Diagnose output]

What this is not

  • Not a hosted MCP product. https://mcp.gfbytes.com is 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:

bash
git clone https://github.com/GFB2026/mcp-oauth-connect.gitcd mcp-oauth-connectpython 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:

bash
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:

text
/plugin marketplace add GFB2026/mcp-oauth-connect/plugin install mcp-oauth-connect@mcp-oauth-connect

Grok Build:

text
grok plugin marketplace add GFB2026/mcp-oauth-connectgrok 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.

来源：README.md，提交 2673411

工具

0
该服务器需要登录，因此 SourceWeft 无法在没有账号的情况下读取其工具，也未收录。已连接账号所能看到的内容可能因账号及其权限而异。

版本历史

1
  1. v0.2.0最新Sep 16, 2026

评分

已满足适用检查项的 85%

该评分衡量此收录条目的完整程度，依据注册中心条目、端点与公开来源计算得出。它不是对服务器本身的评价，也不表示服务器安全或当前可用：可连通性是带日期的检查结果，评分也不包含安装量或用户评价。

  • 近 30 天内可连通必需25 分
  • 已声明认证方式必需10 分
  • 已列出工具15 分

    请让服务器在无凭据时响应 tools/list，或发布可在沙箱中无凭据启动的软件包。

  • 描述必需15 分
  • 图标10 分
  • 文档15 分
  • 许可证10 分