返回 MCP 设置
文档

MCP 接入说明

oauth

这页集中说明 PromptMinder 远程 MCP 能做什么，以及如何把它装进 Cursor、Claude、ChatGPT 和其他 AI 客户端。授权一次后，agent 就能用模糊查询或斜杠快捷方式取出你的提示词。

功能

只读查找：搜索提示词摘要、按 id 取完整内容、列出可访问工作区。客户端也可调用名为 prompt 的 MCP prompt。

授权

正式路径是 Clerk OAuth。首次连接会弹出 PromptMinder 登录页。本地调试也可用 CLI Token 作为 Bearer。

快速开始

不需要安装本地 npm 包。把公开 HTTPS 地址加到客户端，完成一次 OAuth 即可开始查询。

01

复制 MCP 地址

所有客户端都连接这个 Streamable HTTP 地址。

https://www.prompt-minder.com/mcp
02

加到 AI 客户端

Cursor 写入 mcp.json，Claude Code 执行一条命令，ChatGPT 粘贴到自定义连接器。

claude mcp add --transport http promptminder https://www.prompt-minder.com/mcp
03

完成 OAuth 授权

客户端会显示 Needs login。点登录后在浏览器完成 PromptMinder 授权。

Open the login prompt in your MCP client, then approve PromptMinder.
04

试一次查询

用斜杠快捷方式或自然语言让 agent 取出提示词。

/code-review

按客户端安装

下面配置都指向同一个远程地址。支持 OAuth 的客户端会先显示 Needs login，授权完成后即可调用工具。

Cursor

Cursor 只走 DCR，不支持 Clerk CIMD。把 CLI Token 写入本机 ~/.cursor/mcp.json，不要点 Login。仓库里只保留 ${env:PROMPTMINDER_TOKEN} 占位。

{
  "mcpServers": {
    "promptminder": {
      "url": "https://www.prompt-minder.com/mcp",
      "headers": {
        "Authorization": "Bearer pm_xxx"
      }
    }
  }
}

Claude Code

在终端执行这条命令。首次调用工具时会打开浏览器授权。

claude mcp add --transport http promptminder https://www.prompt-minder.com/mcp

Claude Desktop

写入 Claude Desktop 的 mcpServers。若当前版本还不接受远程 URL，用 mcp-remote 做本地桥接。

{
  "mcpServers": {
    "promptminder": {
      "command": "npx",
      "args": [
        "-y",
        "mcp-remote",
        "https://www.prompt-minder.com/mcp"
      ]
    }
  }
}

ChatGPT

在 ChatGPT 的 Connectors / 自定义连接器里粘贴 MCP 地址，然后完成 OAuth。

https://www.prompt-minder.com/mcp

VS Code Copilot

在工作区创建 .vscode/mcp.json，或在用户 MCP 设置里添加 HTTP 服务器。

{
  "servers": {
    "promptminder": {
      "type": "http",
      "url": "https://www.prompt-minder.com/mcp"
    }
  }
}

Windsurf

把配置写入 Windsurf 的 MCP 设置（通常是 mcp_config.json），保存后完成登录。

{
  "mcpServers": {
    "promptminder": {
      "url": "https://www.prompt-minder.com/mcp",
      "headers": {
        "Authorization": "Bearer pm_xxx"
      }
    }
  }
}

其他 MCP 客户端

任意支持 Streamable HTTP 和 OAuth 的客户端，把服务器 URL 设为这个地址即可。

https://www.prompt-minder.com/mcp

当前可用能力

MVP 只开放只读查找。search_prompts 返回摘要，完整内容必须再调 get_prompt。不传 team_id 时默认搜索你能访问的全部工作区。

search_prompts

用自然语言、斜杠快捷方式、标签或 id 搜索提示词摘要。可选 team_id、limit（1–20，默认 8）。

get_prompt

用搜索结果里的 id 取出完整提示词内容。

list_teams

列出可访问的个人空间和团队空间。个人空间的 team_id 为 null。

MCP Prompt

名为 prompt 的 MCP prompt 会按 query 查找。唯一高置信匹配时直接返回完整内容；多条结果会列出 id，再调用 get_prompt。

查询快捷方式

这些写法可用于 search_prompts 的 query，也可用于客户端里的 /prompt。

/code-review

按标题快捷方式查找。连字符、下划线和空格等价。

tag:writing 或 #sql

按标签过滤。

帮我找周报

模糊匹配标题、描述和标签。

id:<uuid>

按精确 id 取出一条。

team:<uuid>

把本次查询限制在指定团队。也可单独传 team_id 参数。

给 agent 的示例说法

把 MCP 接上之后，可以直接用这些句子让客户端去取提示词。

斜杠快捷方式

用 PromptMinder 找出 /code-review，按它的步骤审查这次改动。

自然语言

帮我在 PromptMinder 里找周报相关提示词。

先选工作区再搜索

先列出我的 PromptMinder 团队，再在其中搜 tag:sql。

发现与授权端点

兼容 RFC 9728 / RFC 8414 的客户端可以自动发现资源服务器和授权服务器，不必手写 OAuth 细节。

发现与授权端点

https://www.prompt-minder.com/mcp
https://www.prompt-minder.com/.well-known/oauth-protected-resource/mcp
https://www.prompt-minder.com/.well-known/oauth-authorization-server
https://www.prompt-minder.com/oauth/register

常见问题排查

先看客户端里的 Needs login 或 401，再对照下面几类高频问题。

Needs login

客户端还没完成 OAuth。点 Login，在浏览器登录 PromptMinder 并批准访问。

HTTP 401

OAuth token 无效或已过期。断开后重新授权。如果用的是 CLI Token，确认 token 仍有效且以 Bearer 发送。

搜不到结果

先调用 list_teams 确认工作区。不传 team_id 会搜全部可访问空间；个人空间不要传团队 id。试试更短的词或 /标题快捷方式。

Incompatible auth server / DCR

Cursor 只认 Dynamic Client Registration。Clerk 元数据没有 registration_endpoint，再点 Login 也不会过。把 CLI Token 写成 Authorization: Bearer，或等本服务的 /oauth/register 生效后再试 OAuth。

Claude Desktop 不认 url

旧版只支持本地 stdio。改用 npx -y mcp-remote <MCP 地址> 做桥接，或升级到支持远程 MCP 的版本。

Cursor 为什么不能点 Login

Cursor 会先访问 /mcp，401 后去发现 clerk.prompt-minder.com。那份元数据没有 registration_endpoint，Cursor 又不支持 Clerk CIMD。本服务现在会公布 /oauth/register；在此生效前请用 CLI Token。

Cursor 请用 CLI Token

Cursor 桌面版经常读不到终端里的 export。本机 ~/.cursor/mcp.json 直接写 Bearer 更稳，不要把真实 token 提交到 git。

管理 CLI Tokens
{
  "mcpServers": {
    "promptminder": {
      "url": "https://www.prompt-minder.com/mcp",
      "headers": {
        "Authorization": "Bearer pm_xxx"
      }
    }
  }
}