一次配置，按约定调用。

发布状态：v0.3.0 安装包和文档站已上线，MCP Registry 记录当前为 active。该记录提供可发现的安装包元数据；OpenAI、Claude 的插件目录审核是独立流程。

1. 安装已发布版本

支持 MCPB 0.4 / uv 运行时的桌面客户端，可以直接打开 Release 中的 .mcpb 安装包。宿主管理 Python，安装表单填写实际后台地址和可选消费密钥。旧版宿主可使用下列 wheel / stdio 方式。

python3 -m venv .venv
.venv/bin/python -m pip install "git+https://github.com/zma-petterzhang/guardmarket.git@v0.3.0"
.venv/bin/guardmarket-mcp --version

无需 Git：从 GitHub Release 下载 wheel，校验 SHA256SUMS 后用 pip 安装。本包尚不宣称已在 PyPI 发布。

2. 连接自己的后台

设置 GUARDMARKET_URL 为实际后台 HTTPS origin。本机开发可以使用 http://127.0.0.1:8787。默认无凭据可搜索和查看详情；其他操作需要通过环境变量或安全文件配置消费 API Key。不要将凭据复制到聊天或 GitHub。

3. 选择客户端

• Claude Desktop：绝对路径启动 stdio 客户端。
• Claude Code：使用 claude mcp add 或项目 .mcp.json。
• Qwen Code：在 .qwen/settings.json 配置 mcpServers。
• Qwen-Agent：将 MCP server 配置放入 Assistant 的 function_list。
• Codex：配置 stdio command 及凭据环境变量。

4. 检查真实输出

先 market.search，再 market.describe，最后按准确 ID 调用 market.invoke。调用必须携带价格上限和幂等键；结果不确定时只允许复用原键与原参数。

网页端与官方目录

ChatGPT 和 Claude 网页连接器需要公网 HTTPS MCP endpoint 和已配置的授权流程。GitHub Pages 是静态文档，不能运行 Python 后台。公开仓库并不代表自动收录、自动安装、官方审核通过或推荐。

详见 完整客户端配置与官方文档来源。