SurveyNinja

快速开始  |  技能  |  工具  |  可以询问什么  |  连接方式

SurveyNinja MCP 服务和现成技能，可供你的 AI 助手使用。用简单的语言描述一份调查，助手就会在你的账户中创建调查、在发布前检查、读取回复，并准备一份可供发送的报告。

可用于 Claude、ChatGPT、Claude Code、Cursor、VS Code、Codex、Gemini CLI，以及其他可连接远程 MCP 服务的助手。所有 SurveyNinja 方案都包含此服务，免费方案也不例外。

You:  Build a survey for our repair shop customers: rate the work and collect
      contacts for a follow-up visit.
AI:   ✓ picked question types  ✓ built 7 questions and 2 branches  ✓ applied a theme
      The draft is ready and does not open by its link yet. Publish it?

快速开始

1. 准备一个 SurveyNinja 账户。 如果还没有账户，免费注册。
2. 添加服务 https://mcp.surveyninja.io/mcp/v1 到你的助手中。各助手的操作步骤见下文。
3. 授权访问。 助手提示时，登录 SurveyNinja，选择一个工作区，然后点击 Allow access。 大多数助手不需要密钥；其余助手请按下文所示使用 API 密钥。
4. 询问：“显示我的调查，以及本周收到的回复数量。”

Claude Code：一键安装全部内容

该插件会一次性添加 MCP 服务和所有技能：

/plugin marketplace add surveyninjaio/surveyninja-mcp
/plugin install surveyninja@surveyninja

然后输入 /mcp，选择 SurveyNinja 服务并登录。如只需服务，不需要技能：

claude mcp add --transport http surveyninja https://mcp.surveyninja.io/mcp/v1

Claude 和 ChatGPT

Claude 网页版或桌面应用：Settings → Connectors → Add custom connector。输入名称（例如 SurveyNinja）和服务地址，点击 Add，然后点击 Connect，并在 SurveyNinja 中授权访问。对于 Claude Team 和 Enterprise，需先由组织所有者添加连接器，然后每位成员再进行连接。

**ChatGPT：**在 ChatGPT 设置中开启开发者模式（部分 ChatGPT 方案提供此功能），使用服务地址和 OAuth 身份验证创建连接器，然后在 SurveyNinja 中授权访问。

其他助手

一键安装：

{
  "mcpServers": {
    "surveyninja": {
      "url": "https://mcp.surveyninja.io/mcp/v1"
    }
  }
}

{
  "servers": {
    "surveyninja": {
      "type": "http",
      "url": "https://mcp.surveyninja.io/mcp/v1"
    }
  }
}

gemini extensions install https://github.com/surveyninjaio/surveyninja-mcp

{
  "mcpServers": {
    "surveyninja": {
      "httpUrl": "https://mcp.surveyninja.io/mcp/v1"
    }
  }
}

[mcp_servers.surveyninja]
url = "https://mcp.surveyninja.io/mcp/v1"
bearer_token_env_var = "SURVEYNINJA_API_KEY"

Authorization: Bearer YOUR_API_KEY

相同配置文件可在 clients/ 中找到，包含故障排查的完整步骤见 docs/connect.md。

一览

功能

问卷。 从头开始、使用模板或借助 AI 创建问卷。编辑问题、逻辑、设计和设置， 然后发布。

回答。 读取回答、为其添加标签，并保持账户整洁。

报告。 摘要、报告、带筛选条件的报告和 AI 报告。可导出为 CSV、Excel、Word、SPSS 和 PDF，也可通过公开 链接分享结果。

发送。 通知、Webhook、集成和团队邀请。

按类别查看完整列表，请访问 docs/tools.md；入门提示语请查看 docs/prompts.md。

技能

技能是为助手准备好的操作指南。你可以说“整理一下开放式回答”，技能就会告诉 它要调用哪些工具、按什么顺序调用，以及如何呈现结果。技能是纯文本指令，不包含代码： 不会安装或运行任何内容。每项技能也都发布在 surveyninja.io/skills 上，并附有结果示例。

构建与分享

发布前检查

理解结果

管理回复

保持账户整洁

所有技能打包在一个归档文件中：all.zip。

不使用插件安装技能

只需一条命令即可用于任何助手：skills 会查找已安装的 Agent，并询问你要将技能放在哪里。

npx skills add surveyninjaio/surveyninja-mcp

或者将归档文件解压到助手读取技能的文件夹中，然后重启助手：Claude Code 使用 .claude/skills/，Codex 和 Cursor 使用 .agents/skills/，Gemini CLI 使用 .gemini/skills/。详见 skills/README.md。

安全

• 使用 Allow access 时，助手只能在你选择的那个工作区中工作；离开该工作区或移除连接器后，助手便会失去访问权限。你在 Settings → API / MCP 中删除 API key 后，该密钥会立即失效。
• 删除问卷或回复等无法撤销的工具带有 destructiveHint 注释，因此客户端可以在调用前询问你。确认前，请先阅读助手即将执行的操作。
• 每项技能都有一个“禁止事项”部分，说明助手未经你明确许可不得执行哪些操作。
• 此代码仓库中不包含任何机密信息。配置使用 YOUR_API_KEY 作为占位符。如果你发现疑似真实密钥的内容或安全问题，请查看 SECURITY.md。

链接

• SurveyNinja
• MCP 服务页面
• 技能目录
• MCP 和 API 文档
• LinkedIn

许可证

MIT，详见 LICENSE。许可证涵盖此代码仓库中的内容：文档、配置和技能。 SurveyNinja 服务本身受其用户协议约束。