Docs: add an OpenClaw compatibility note for Bearer-header vs query-token auth
还没有人认领这个 Issue。
评估
- 难度
- 1/5
- 预计耗时
- 1-3 小时
- 新手友好度
- 72/100
- Issue 类型
- 文档
- 描述清晰度
- 描述清楚
- 活跃度
- 冷清
- 技术栈
- python
调研方向
从 README 中的客户端设置部分开始，找到现有的 ?token= 回退方式记录在哪里。阅读相关的身份验证文档，说明何时需要使用 Authorization 标头或查询令牌，并描述它们在安全性方面的权衡。添加一条关于兼容类似 OpenClaw 的客户端的简短说明，并从 README 链接到该说明；当两种身份验证流程及其权衡都清楚时，任务即告完成。
由索引模型根据 Issue 内容生成。
描述
Opened by @francescobianco as an adoption-focused good first issue.
Summary
I tested this MCP server through an OpenClaw-style host that can connect to remote MCP endpoints but does not consistently expose custom HTTP headers in every setup path. The current docs mention the ?token= fallback, but there is no compatibility note aimed at hosts in this family.
Expected
A short doc section explaining when header-based auth works, when ?token= is required, and the security tradeoffs.
Actual
Users have to infer the right auth mode by reading multiple places in the repo.
Suggested acceptance criteria
- Add one short compatibility note for OpenClaw-like clients.
- Mention both
Authorizationheader and?token=flows. - Link the note from the README client setup area.
- 主要语言
- Python
- 星标
- 22
- 派生
- 4
- PR 合并指标
- 30 天内没有已合并 PR
环境准备
- 提供 Dockerfile 或 Docker Compose 文件
- 没有 Pull Request 模板
- 阅读贡献指南
从这里开始
- 先读完整个 Issue，再读项目的贡献指南。
- 在 Issue 下留言说明你要接手 —— 这能避免两个人做同样的事。
- Fork 仓库，在一个分支上完成修改。
- 提交 Pull Request，并在描述里引用这个 Issue 编号。
openapi/mcp-server 的其他 Issue
-
难度 2/5 1-3 小时 新手友好度 68/100
openapi/mcp-server#33 ·
-
难度 2/5 1-3 小时 新手友好度 65/100
openapi/mcp-server#29 ·
-
难度 1/5 1-3 小时 新手友好度 73/100
openapi/mcp-server#25 ·
-
Testing: add a host-agnostic smoke test checklist for OpenClaw, NanoClaw, and NemoClaw-style clients未关闭
难度 2/5 1-3 小时 新手友好度 72/100
openapi/mcp-server#24 ·
-
enhancement good first issue help wanted
难度 2/5 1-3 小时 新手友好度 65/100
openapi/mcp-server#19 ·
查看 openapi/mcp-server 的全部 Issue
相似的 Issue
-
customer-reported question
难度 2/5 1-3 小时 新手友好度 62/100
Azure/azure-sdk-for-python#49548 · 1 条评论 · 1 个 reaction ·
维护者通常 1 天内回复
-
难度 1/5 1 小时以内 新手友好度 88/100
btclib-org/btclib-wallet#409 ·
维护者通常 1 天内回复
-
Phase 2 PSA Capability & Career Profile
难度 2/5 1-3 小时 新手友好度 62/100
bcgov/digital-journeys#2310 ·
-
bug good first issue
难度 2/5 1-3 小时 新手友好度 78/100
fastmachinelearning/hls4ml#1582 ·
维护者通常 3 天内回复
-
Sort models未关闭enhancement good first issue
难度 2/5 1-3 小时 新手友好度 62/100
维护者通常 1 天内回复