FrancoLabs

FrancoLabs MCP Server

FrancoLabs — UX リサーチプラットフォーム — をModel Context Protocol経由で AI アシスタントに接続します。Claude、ChatGPT、その他の MCP クライアントを使って、調査の作成・管理、テンプレートの閲覧、参加者の回答や分析結果の確認、AI に基づく分析の実行、インサイトからプロダクトの機会への展開を行えます。

• エンドポイント： https://francolabs.vercel.app/mcp
• トランスポート： Streamable HTTP（MCP プロトコル 2025-06-18）
• 認証： OAuth 2.1（Dynamic Client Registration + PKCE）または Personal Access Token
• レジストリ： io.github.glauberfrancodesign/francolabs

---

接続

Claude（claude.ai / Desktop）

設定 → コネクター → カスタムコネクターを追加 → URL：

https://francolabs.vercel.app/mcp

OAuth の同意画面を完了します。付与するスコープを選択でき、読み取り専用アクセスの切り替えもできます。

ChatGPT

Developer Modeを有効にしてから、設定 → コネクター → 追加 → 同じ URL を指定します。OAuth フローで認証します。

Claude Code / Cursor（トークンを手動で設定）

設定 → インテグレーションで Personal Access Token を生成し、次の手順を実行します。

claude mcp add --transport http francolabs \
  "https://francolabs.vercel.app/mcp" \
  --header "Authorization: Bearer <your-token>"

---

ツール

2 つのスコープが記載されたツールには、両方のスコープが必要です。AIは、言語モデルを呼び出して AI クレジットを使用するツールを示します。モデルに渡されるのは、決定論的なダイジェストと厳選されたインサイトのみで、メールアドレスと電話番号は事前にマスキングされます。

テンプレート、ワークスペース、プロジェクト

ツール	スコープ	説明
list_question_types	templates:read	質問／ブロックの種類と、正確な設定形式および有効な例
list_templates	templates:read	調査テンプレート。カテゴリーで絞り込み可能
list_workspaces	projects:read	所属するワークスペース（チーム）と、それぞれの自分のロール
list_projects	projects:read	自分のプロジェクト。ステータスで絞り込み可能
get_project	projects:read	ID で指定した単一のプロジェクト
get_plan	projects:read	ワークスペースのプランと現在の利用状況：上限、現在適用される制限、付与内容と拡張アクセスの終了時期、ユーザーごとの AI 作成上限
create_project	projects:write	プロジェクトを作成（特定のワークスペースを指定可能）

調査

ツール	スコープ	説明
list_studies	studies:read	ステータスやプロジェクトで絞り込んだ調査
get_study	studies:read	ブロックと設定を含む調査の全情報
create_study	studies:write	Draft 調査を作成。ブロックは list_question_types に基づいて検証されます
update_study	studies:write	タイトル、ブロック、プロジェクトを更新。settings は部分更新です
set_study_status	studies:write	Draft の開始、Paused 調査の一時停止・再開、または調査の完了
delete_study	studies:write	調査とその回答を完全に削除
generate_study_from_objective	studies:read	AI — リサーチ目標を型付きの調査スケルトンに変換
review_study_quality	studies:read	AI — ブロックごとの品質スコアを含むアンケート設計レビュー

回答、分析、インサイト

ツール	スコープ	説明
list_responses	responses:read	回答者の生の回答を新しい順に表示します — 回答者が記入した個人データが含まれる場合があります。メールアドレスと電話番号をマスキングするには、redact: true を渡してください
get_study_analytics	responses:read	集計された KPI：回答数、完了率、所要時間、NPS、分布
get_study_digest	responses:read	すべての質問形式を対象とした、決定論的で PII を含まない統計ダイジェスト
run_universal_analysis	responses:read + studies:write	AI — 分析全体を実行／更新します（ピン留めされていない AI インサイトを置き換えます）
analysis_chat	responses:read	AI — ダイジェストとキャッシュされた分析に基づいて質問します
get_insights	responses:read	厳選されたインサイトカードを、ピン留めされたものから先に表示します
upsert_insight	responses:read + studies:write	厳選されたインサイトカードを作成または編集します
rate_insight	responses:read + studies:write	インサイトへのフィードバック 👍/👎 を記録します
suggest_tags	responses:read + studies:write	AI — 一貫したプロダクト分類体系に沿ってインサイトにタグを付けます
set_insight_tags	responses:read + studies:write	1 件のインサイトのタグを置き換えます
research_memory_query	responses:read + studies:write	AI — 過去の厳選されたインサイトに基づいて、複数の調査にまたがる質問に回答します

機会と意思決定

ツール	スコープ	説明
list_opportunities	responses:read	調査から抽出されたプロダクトの機会
create_opportunity_from_insights	responses:read + studies:write	AI — インサイトをもとに、機会のドラフトを作成します
suggest_next_research_steps	responses:read	AI — 未解決の機会に伴うリスクを軽減する、3～5 件のフォローアップ調査
generate_decision_packet	responses:read + studies:write	AI — ステークホルダー向けの意思決定資料（Markdown）
list_decision_packets	responses:read	調査用にすでに生成された意思決定資料
export_opportunity	responses:read + studies:write	機会を Linear の課題としてエクスポートします — 社内ユーザーのみ
list_external_task_links	responses:read	調査の機会からすでに作成された Linear の課題

連絡先（個人データ）

ツール	スコープ	説明
list_contacts	contacts:read	ワークスペースの回答者の連絡先 — 個人データ（メールアドレス、名前、ロケール／国、調査への同意、タグ、回答数）
get_contact	contacts:read	回答した調査とともに、1 件の連絡先を取得します — 個人データ
tag_contacts	contacts:write	回答者をセグメント化するため、連絡先のタグを追加／削除します — タグに機密情報を絶対に含めないでください

create_project と create_study はワークスペースに書き込みます — workspaceId （list_workspaces を参照）を渡すか、省略するとデフォルトで最も古いワークスペースが使用されます。 書き込みツールを使用するには、調査のワークスペースでエディター権限（オーナー、管理者、メンバー）も必要です。閲覧者は読み取りのみ可能です。

リソースも 2 つ公開されています：francolabs://templates と francolabs://question-types。

スコープ

templates:read · projects:read · projects:write · studies:read · studies:write · responses:read · contacts:read · contacts:write

contacts:read と contacts:write は、回答者の個人データ（メールアドレス、名前、ロケール／国、調査への同意、タグ、回答履歴）へのアクセスを許可します。これらはオプトインです。承認画面と読み取り専用トークンプリセットではチェックが外れているため、連絡先ベースへのアクセスが必要なアシスタントにのみ許可してください。 responses:read は生の回答を返します。回答者が入力した個人データが含まれる場合もあります。

許可していないツールは tools/list に表示されません。読み取り専用の許可では、スコープに関係なく、すべての書き込みツールがサーバー側でブロックされます。

セキュリティ

• トークンは SHA-256 ハッシュとしてのみ保存されます。平文で保存されることはありません。
• リクエストごとに有効期間の短い（5 分）JWT が発行され、すべてのデータアクセスはユーザーごとの行レベルセキュリティのもとで実行されます。サービスロールはトークンの照合にのみ使用されます。
• OAuth のアクセストークンとリフレッシュトークンの有効期間は 30 日間で、接続の有効期間が 90 日を超えることはありません。アクセスは「設定」→「連携」からいつでも取り消せます。また、クライアントは失効エンドポイント（RFC 7009）でトークンを失効させることができます。
• OAuth は RFC 9728（保護されたリソースのディスカバリー）、RFC 8414（AS メタデータ）、RFC 7591（動的クライアント登録）、および PKCE S256 に準拠しています。

ソース

このリポジトリには、透明性を確保するためにサーバーのソースコードがミラーリングされています。サーバーは Supabase Edge Function（src/mcp、src/mcp-oauth、src/_shared）として実行されます。

---

© FrancoLabs. All rights reserved.