YaniFend MCP Server 是一个面向 YaniFend 反馈问卷的模型上下文协议（Model Context Protocol，MCP）服务器。它使 LLM 客户端能够代表已登录的站点所有者与 YaniFend 后台交互，在聊天中完成列出人物角色（personages）、管理问卷问题、拉取已收集的答案等操作。
用途 YaniFend 是一个可直接嵌入的反馈组件，允许访客在任意网站上留下结构化反馈——只需一个脚本标签，无需框架（支持自定义站点、SPA、WordPress 等）。本 MCP 服务器是管理 YaniFend 实例的 LLM 原生方式，让 AI 客户端无需离开对话即可操作问卷与答案。
主要能力 服务器提供 33 个工具，涵盖人物角色与集成（Personages & integration）、问卷撰写（Questionary authoring）、答案与托管表单（Answers & hosted forms）、通知（Notifications，仅托管端点和已认证代理）等类别，另包含 set_character / get_character（人物角色外观）、update_widget_style、delete_personage。所有工具均限定于已认证的 YaniFend 账号，只能查看和编辑自己站点的数据。它还可提供可复用的起始项（starting points）供 MCP 客户端使用。
使用方式 推荐使用托管端点，采用 Streamable HTTP 传输和 OAuth 2.1（PKCE + RFC 7591 动态客户端注册）。无需预先注册——Claude、ChatGPT 和 Grok 在首次连接时自行注册，随后提示登录 YaniFend（支持 Google / GitHub / Facebook / LinkedIn / 邮箱）。
Claude（claude.ai 及 Claude 应用）：添加自定义连接器，URL 为 https://app.yanifend.com/mcp，免费个人计划即可使用。
ChatGPT：打开 Settings → Security and login，开启 Developer mode；打开 Plugins，点击 +，选择 Create app → Create MCP App；命名为 YaniFend，Server URL 设为 https://app.yanifend.com/mcp，认证选择 OAuth；ChatGPT 会自行找到登录设置，高级设置保持默认；勾选确认并点击 Create；点击 Sign in with YaniFend 并按平常方式登录、批准请求；回到 Plugins，打开 YaniFend 并点击 Refresh 加载其工具。
Grok：打开 Plugins → New Connector → Custom；命名为 YaniFend，Server URL 设为 https://app.yanifend.com/mcp，点击 Add Connector，无需其他输入，Grok 会自行注册；浏览器中打开 YaniFend 登录页，按平常方式登录并批准请求；开始新对话即可询问表单相关操作。
替代方式：桌面扩展 / 本地 stdio 代理（本仓库）。本仓库提供一个 stdio MCP 服务器，代理到托管端点。通过桌面扩展设置或 YANIFEND_EMAIL / YANIFEND_PASSWORD 环境变量配置账号邮箱和密码，它会通过 HTTPS 登录并将每次工具调用转发到 https://app.yanifend.com/mcp——同样 33 个工具、相同 schema 和注解，严格限定于自己的账号。未提供凭据时，它仍提供工具目录以供注册表自省，并在任何调用时返回配置提示。这是与上述托管连接器不同的登录路径：使用 YaniFend 邮箱和密码，而非连接器的 OAuth 登录，因此上述受支持客户端说明不适用于它。作为 Claude Desktop 扩展：安装 .mcpb 包（用 npx @anthropic-ai/mcpb pack 构建），然后在扩展设置中输入 YaniFend 邮箱和密码。密码由 Claude Desktop 的操作系统钥匙串存储，且仅发送至 app.yanifend.com。
适用场景 适用于使用 YaniFend 的站点所有者（HR / 招聘 / SaaS / 电商，自建或 WordPress）通过 Claude、ChatGPT 或 Grok 管理反馈问卷和查看答案。
限制 Claude Code、Cursor 等登录回调到 localhost 地址的 MCP 客户端目前不支持，其登录回调会被拒绝，连接无法完成；其他助手尚未测试。目前请使用 Claude、ChatGPT 或 Grok。托管连接器与本地代理是两条不同的登录路径。
隐私 完整政策见 https://yanifend.com/privacy。数据收集：扩展仅收集你在设置中输入的 YaniFend 账号凭据及你在聊天中提供的工具输入，不读取文件、浏览历史或机器上其他内容。使用与存储：凭据由 Claude Desktop 本地存储（操作系统钥匙串），仅用于经 HTTPS 从 app.yanifend.com 获取短期访问令牌；工具调用和结果直接在机器与 YaniFend API 之间传输，扩展不保留数据库，也不记录你的数据日志。第三方共享：除 YaniFend（app.yanifend.com）外不发送给任何方，无分析、无跟踪器。数据保留：扩展本身除内存中的会话令牌外不保留任何内容（退出即丢弃）；反馈数据存于你的 YaniFend 账号，遵循 YaniFend 隐私政策的保留条款，删除账号会级联删除全部数据。联系：support@yanifend.com。许可：MIT，见 LICENSE。
