SurveyNinja

クイックスタート  |  スキル  |  ツール  |  質問例  |  接続方法

SurveyNinja の MCP サーバーと、AI アシスタント向けのすぐに使えるスキルです。アンケートの内容を普段の言葉で説明すると、アシスタントがアカウント内に作成し、公開前に確認して、回答を読み取り、送信できるレポートを作成します。

Claude、ChatGPT、Claude Code、Cursor、VS Code、Codex、Gemini CLI、およびリモート MCP サーバーに接続するその他のアシスタントで利用できます。SurveyNinja のすべてのプランに含まれており、Free でも利用できます。

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 にサインインし、ワークスペースを選択して アクセスを許可 をクリックします。ほとんどのアシスタントではキーは不要です。それ以外の場合は、以下の手順に従って 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。

プラグインを使わずにスキルをインストールする

どのアシスタントでも、コマンドを 1 つ実行するだけです。skills がインストール済みのエージェントを見つけ、スキルの配置先を尋ねます。

npx skills add surveyninjaio/surveyninja-mcp

または、アーカイブをアシスタントがスキルを読み込むフォルダーに解凍して、再起動してください。Claude Code の場合は .claude/skills/、Codex と Cursor の場合は .agents/skills/、Gemini CLI の場合は .gemini/skills/ です。詳しくは skills/README.mdをご覧ください。

セキュリティ

• アクセスを許可すると、アシスタントは選択した 1 つのワークスペースで動作し、そのワークスペースを離れるかコネクタを削除するとアクセスできなくなります。API keyは、Settings → API / MCPで削除した時点で使用できなくなります。
• アンケートや回答の削除など、元に戻せないツールにはdestructiveHint注釈が付いているため、クライアントは呼び出し前に確認できます。確定する前に、アシスタントが実行しようとしている内容を確認してください。
• すべてのスキルには「してはいけないこと」のセクションがあり、あなたの指示なしにアシスタントが実行してはいけない操作を記載しています。
• このリポジトリに秘密情報はありません。設定ではYOUR_API_KEYをプレースホルダーとして使用しています。本物のキーのように見えるものやセキュリティ上の問題を見つけた場合は、SECURITY.mdをご覧ください。

リンク

• SurveyNinja
• MCP サーバーのページ
• スキルカタログ
• MCP と API のドキュメント
• LinkedIn

ライセンス

MIT。詳しくはLICENSEをご覧ください。このライセンスの対象は、このリポジトリに含まれるドキュメント、設定、スキルです。SurveyNinja サービス自体は、利用規約に基づいて提供されています。