# PlugMate 觅件 · MCP 接入

> PlugMate 觅件 自带 MCP server，让支持 MCP 的 AI 工具用中文检索插件库、管理收藏；教程页有各客户端的逐步配置。

## 端点

| 端点 | 用途 |
|------|------|
| `https://plugmate.figmod.top/mcp` | 插件目录：搜索、详情、收藏夹（所有登录用户；管理员另有运营工具） |
| `https://plugmate.figmod.top/mcp/blog` | 博客读写：公开发布物检索 + 管理员的两阶段写操作 |

## 授权

- OAuth 2.0 + PKCE；授权服务器元数据：`https://plugmate.figmod.top/.well-known/oauth-authorization-server`
- 受保护资源元数据：`https://plugmate.figmod.top/.well-known/oauth-protected-resource/mcp`（博客为 `/mcp/blog`）
- 动态客户端注册：`POST https://plugmate.figmod.top/oauth/register`；token 端点 `/oauth/token`（支持 refresh token）
- 身份即网站账号：授权页用 Figma 登录，access token 1 小时、refresh token 30 天

## 工具（插件目录）

- 搜索与详情：`search_plugins`、`get_plugin`、`list_categories`、`whoami`
- 收藏夹：`list_favorite_folders`、`list_folder_plugins`、`create_favorite_folder`、`set_plugin_favorite`
- 与网页版同一套配额：免费用户每日搜索/翻页受限，收藏与翻页能力按会员身份放开
- 管理员追加 `admin_*` 工具：插件/分类/用户会员/试用额度/看板管理，以及 Figma 社区导入（`admin_lookup_figma_plugin` 查重 → `admin_create_plugin` 入库）

## 博客端点（/mcp/blog）

- 公开读：`list_posts`、`get_post`、`search_public_plugins`、`list_public_categories`、`get_public_plugin`
- 写操作两阶段：`prepare_post`/`prepare_visibility`/`prepare_delete` 生成带确认文案的 intent，`commit_intent` 才执行 —— 防止 AI 误发内容

## 接入教程

[MCP 教程](https://plugmate.figmod.top/mcp-tutorial) 覆盖 WorkBuddy、ZCode、Kimi、DeepSeek DSH、ChatGPT、Claude、Grok、Cursor 的配置步骤；协议版本兼容 2024-11-05 至 2025-11-25。

## 相关文档

- [llms.txt](https://plugmate.figmod.top/llms.txt)：本站 Markdown 文档索引
- [站点概览](https://plugmate.figmod.top/docs/overview.md)：产品定位、面向人群与关键事实
- [功能说明](https://plugmate.figmod.top/docs/features.md)：浏览、搜索、收藏与在 Figma 中打开插件
- [收录数据](https://plugmate.figmod.top/docs/catalog.md)：场景分类清单、收录规模与字段说明
- [免费与价格](https://plugmate.figmod.top/docs/pricing.md)：免费限制、会员套餐与升级方式