QualiTaTi

AI エージェント向け QualiTaTi

Claude Code、Codex、OpenCode、Cursor、Claude Desktop、または任意の MCP クライアントから、QualiTaTi で AI が進行するインタビュー、対話型アンケート、質的分析 を実施できます。

ホスト型の MCP サーバーが処理を行います。このリポジトリでは、プラグインシステムを備えたツール向けにインストール可能なプラグインとしてパッケージ化し、それ以外のツール向けに 1 行で設定する方法を説明しています。プラグインには、QualiTaTi のワークフロー（インタビュー調査の設定、アンケートの作成、結果の確認）をエージェントに教える 3 つのスキルと、2 つのスラッシュコマンドが含まれています。

前提条件

1. QualiTaTi アカウント（無料プランで構いません）。
2. 個人用 API キー：qualitati.com → Profile → API keys（キーは qt_ で始まります）。キーにはプラン、クォータ、請求情報が引き継がれます。いつでもそのページで取り消せます。
3. シェルに設定します：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 / アプリ

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

公式 MCP Registry に io.github.lanceyuu/qualitati として登録されています（このリポジトリ内の server.json）。そのため、レジストリ対応のクライアントやディレクトリでは、上記の設定を行わなくても見つけられます。

エージェントができること

ツール	内容
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	対話型アンケートを作成して公開します

人間の参加者は引き続き共有リンクからインタビューを受けます。エージェントは調査を設定し、結果を確認します。

リポジトリ構成

1 つのプラグイン、2 種類のパッケージ構成、共有スキル：

.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

リポジトリのルート自体がプラグインです（cursor.directory がスキャンする Open Plugins の構成です）。また、2 つのマーケットプレイス用ファイルにより、Claude Code と Codex は同じリポジトリからインストールできます。

ライセンス

MIT。QualiTaTi は QualiTaTi の製品です（[email protected]）。