QualiTaTi

面向 AI Agent 的 QualiTaTi

通过 Claude Code、Codex、OpenCode、Cursor、Claude Desktop 或任何 MCP 客户端，在 QualiTaTi 上开展 AI 主持访谈、对话式问卷和定性分析。

一个托管的 MCP 服务负责处理工作；此仓库将其打包为可安装的插件，供支持插件系统的工具使用，并为其他工具提供单行配置。该插件包含三项技能，用于指导 Agent 使用 QualiTaTi 的工作流（设置访谈研究、创建问卷、查看结果），以及两个斜杠命令。

前提条件

1. 一个 QualiTaTi 账户——免费方案即可。
2. 一个个人 API 密钥：qualitati.com → Profile → API keys（密钥以 qt_ 开头）。密钥沿用你的方案、配额和计费设置；你可以随时在那里撤销密钥。
3. 将密钥放入 shell：export QUALITATI_API_KEY=qt_…

实现了 MCP 授权（支持动态客户端注册的 OAuth 2.1）的客户端可以完全跳过密钥：将它们指向服务 URL，然后在浏览器中打开 QualiTaTi 授权页面。Claude Code：claude mcp add --transport http qualitati https://api.qualitati.com/mcp，然后选择 /mcp → Authenticate。

安装

Claude Code

/plugin marketplace add lanceyuu/qualitati-agent-plugins
/plugin install qualitati@qualitati-agent-plugins

你将获得 qualitati MCP 服务（读取 QUALITATI_API_KEY）、各项技能，以及 /qualitati:new-study 和 /qualitati:results。若不使用插件，仅安装服务：

claude mcp add --transport http qualitati https://api.qualitati.com/mcp \
  --header "Authorization: Bearer $QUALITATI_API_KEY"

Codex CLI / app

codex plugin marketplace add lanceyuu/qualitati-agent-plugins
codex plugin add qualitati@qualitati-agent-plugins

或者直接在 ~/.codex/config.toml 中配置服务：

[mcp_servers.qualitati]
url = "https://api.qualitati.com/mcp"
bearer_token_env_var = "QUALITATI_API_KEY"

OpenCode

{
  "mcp": {
    "qualitati": {
      "type": "remote",
      "url": "https://api.qualitati.com/mcp",
      "enabled": true,
      "headers": { "Authorization": "Bearer {env:QUALITATI_API_KEY}" }
    }
  }
}

Cursor

.cursor/mcp.json（或使用 https://qualitati.com/developers 上的 Add to Cursor 按钮）：

{
  "mcpServers": {
    "qualitati": {
      "url": "https://api.qualitati.com/mcp",
      "headers": { "Authorization": "Bearer qt_your_key_here" }
    }
  }
}

Claude Desktop

自定义连接器目前还不能发送固定标头，因此请在 claude_desktop_config.json 中通过 mcp-remote 进行桥接：

{
  "mcpServers": {
    "qualitati": {
      "command": "npx",
      "args": ["-y", "mcp-remote", "https://api.qualitati.com/mcp",
               "--header", "Authorization: Bearer qt_your_key_here"]
    }
  }
}

MCP Registry

该服务以 io.github.lanceyuu/qualitati 的名称列于官方 MCP Registry（此仓库中的 server.json），因此支持注册表的客户端和目录无需上述任何配置即可找到它。

Agent 可以做什么

工具	功能
project_list、project_get、project_create、project_share	查找或设置访谈研究，并获取参与者链接
project_interviews、interview_get、interview_import	查看完成状态、阅读完整访谈记录、导入外部访谈记录
analysis_run、analysis_results、analysis_summary、analysis_digest	运行和查看质量与编码分析、摘要及计数
survey_create、survey_add_question、survey_publish	创建并发布对话式问卷

访谈仍由人类参与者通过分享链接完成；Agent 负责设置研究并查看结果。

仓库结构

一个插件、两种包布局、共享技能：

.claude-plugin/marketplace.json     Claude Code marketplace (this repo, plugin source "./")
.claude-plugin/plugin.json          Claude Code plugin manifest
.agents/plugins/marketplace.json    Codex marketplace (this repo, plugin path "./")
.codex-plugin/plugin.json           Codex plugin manifest (mcpServers -> ./mcp.json, so Codex reads the bearer_token_env_var form)
plugin.json  mcp.json               Codex / Agent Plugins (Open Plugins) manifest + MCP config
.mcp.json                           Claude Code MCP config
skills/  commands/  assets/         shared
server.json                         MCP Registry entry

仓库根目录本身就是插件（Open Plugins 使用的布局，cursor.directory 会扫描该布局）；两个 marketplace 文件让 Claude Code 和 Codex 能够从同一仓库安装插件。

许可证

MIT。QualiTaTi 是 QualiTaTi 的产品（[email protected]）。