Skip to content

docs: clarify OAuth discovery expectations for custom MCP endpoints #52

New issue

Have a question about this project? Sign up for a free GitHub account to open an issue and contact its maintainers and the community.

Sign up for GitHub

By clicking “Sign up for GitHub”, you agree to our terms of service and privacy statement. We’ll occasionally send you account related emails.

Already on GitHub? Sign in to your account

Open
however-yir wants to merge 1 commit into
base: main
Choose a base branch
from
Open

docs: clarify OAuth discovery expectations for custom MCP endpoints #52

Show file tree
Hide file tree
Changes from all commits
Commits
Show all changes
1 commit
Select commit
File filter

Filter by extension

Filter by extension
Conversations
Failed to load comments.
Loading
Jump to
Jump to file
Failed to load files.
Loading
Diff view
Diff view
15 changes: 15 additions & 0 deletions README-CN.md
View file
Open in desktop
Original file line number Diff line number Diff line change
Expand Up @@ -141,6 +141,21 @@ which uvx
或者放到本地客户端的规则中 (以 Cursor 为例):
<img src="https://public-cdn-video-data-algeng.oss-cn-wulanchabu.aliyuncs.com/cursor_video_rule.png?x-oss-process=image/resize,p_50/format,webp" style="display: inline-block; vertical-align: middle;"/>

### 4. OpenCode 添加 MiniMax MCP 后启动失败（配置校验错误）
如果 OpenCode 提示配置校验失败（例如 `mcp.MiniMax` 下字段不被识别），请检查：

- 你的 OpenCode 版本对应的 MCP 配置 schema 是否与当前写法一致；
- 是否按 OpenCode 官方文档将字段映射为该版本支持的结构（本 README 主要提供 Claude/Cursor 示例）；
- 模型 provider 配置与 MCP server 配置是否分别放在各自的配置段中。

建议先以 OpenCode 官方文档为准，再把 `MINIMAX_API_KEY`、`MINIMAX_API_HOST` 等环境变量填入其支持的 MCP 结构。

### 5. MiniMax MCP 是否支持标准 MCP OAuth discovery？
本仓库（`MiniMax-MCP`）主要是 MCP Server 实现，常见接入方式是通过 API Key 环境变量配置。
“添加第三方 MCP 服务时的 OAuth 发现/授权流程”是否可用，取决于具体 MCP 客户端产品（如网页端/IDE 集成）的实现能力，而不只取决于本仓库。

如果你在接入自定义 MCP URL 时遇到 OAuth URL 获取失败，请优先核对对应客户端最新文档中要求的 discovery 地址与 OAuth 配置方式。


## 使用示例

Expand Down
15 changes: 15 additions & 0 deletions README.md
View file
Open in desktop
Original file line number Diff line number Diff line change
Expand Up @@ -140,6 +140,21 @@ Define completion rules before starting:
Alternatively, these rules can be configured in your IDE settings (e.g., Cursor):
<img src="https://public-cdn-video-data-algeng.oss-cn-wulanchabu.aliyuncs.com/cursor_video_rule.png?x-oss-process=image/resize,p_50/format,webp" style="display: inline-block; vertical-align: middle;"/>

### 4. OpenCode fails to start after adding MiniMax MCP config
If OpenCode reports config validation errors (for example, unrecognized keys in `mcp.MiniMax`), verify:

- OpenCode's MCP schema/version matches the config format you are using.
- You translated fields according to OpenCode docs (this README primarily provides Claude/Cursor examples).
- Model provider settings and MCP server settings are configured in their respective sections.

For OpenCode-specific keys and structure, follow the latest OpenCode documentation first, then map MiniMax env vars (`MINIMAX_API_KEY`, `MINIMAX_API_HOST`) into that schema.

### 5. Does MiniMax MCP support standard MCP OAuth discovery endpoints?
This repository (`MiniMax-MCP`) is an MCP server implementation that is typically configured with API key environment variables.
OAuth discovery/login support for adding third-party MCP services depends on the MCP client product (for example, web apps/IDE integrations), not only on this server repository.

If your client reports OAuth URL discovery errors when connecting to a custom MCP endpoint, verify client-side OAuth support and required discovery paths in that client's latest documentation.


## Example usage

Expand Down