ScopeProfit

Scope-to-Profit

フリーランサーやソフトウェアエージェンシー向けのスコープ策定コパイロットを、MCP サーバーとして提供します。 クライアントのまとまりのないアイデア（断片的なテキスト、スクリーンショット、「シンプルなものが欲しいけれど……」など）を、あらゆるAIエージェントが活用できる、正式なバージョン管理付きのスコープ文書に変換します。

信頼できる唯一の情報源： docs/scope-to-profit.md（製品スコープ v1/v2 と、現在のMCPファーストアーキテクチャ）。MCPのセットアップとツールのリファレンスについては、docs/mcp.md をご覧ください。

生成される内容

• 要件（機能要件／非機能要件）と、原文の引用
• 作業を妨げる質問
• 信号機方式で示すリスク
• スコープ（対象／対象外／前提条件／受け入れ基準）
• 工数の範囲見積もり（価格なし）
• 次のステップ

すべてを固定テンプレート 7.1 にまとめ、Markdown、PDF、編集可能なDOCXとしてエクスポートします。

アーキテクチャ（MCPファースト）

ChatGPT · Claude · Cursor · Grok bots · custom agents
                │  MCP (Streamable HTTP / stdio)
                ▼
        Backend API (NestJS) ── scope tools ── LangGraph agent (optional) ── PostgreSQL + persistent storage

• MCP サーバー（主要インターフェース） — POST /api/mcp（Streamable HTTP、ステートレス）と、ローカルホスト向けのstdioエントリーポイントを提供します。20個のツール：create_project、add_client_input（テキスト＋画像URL）、get_tldr、get_scope_document、list_pending_questions、answer_question、update_scope_section、approve_scope、export_document、list_projects、archive_project、get_project、get_conversation、get_input_image、log_change_request、list_change_requests、get_quote、save_quote、export_quote、decide_quote。
• 認証 — ScopeProfit APIキーを使う Authorization: Bearer、またはChatGPT形式のコネクター向けOAuth 2.1（動的クライアント登録＋PKCE）に対応しています。docs/mcp.md をご覧ください。
• バックエンドAPI — データベースとファイルシステムにアクセスする唯一のコンポーネントです。バージョン管理されたBrief（PostgreSQL）を保持し、テンプレート7.1とPDF／DOCXファイルを生成し、オプションのサーバー側スコープエージェントを実行します。
• ランディングページ（apps/landing） — MCPファーストの製品と、各クライアントの接続方法を説明する静的なマーケティングページです。Webアプリはありません。Next.jsクライアントチャット（apps/app）は削除されており、クライアントとの会話はMCP サーバーを使用する任意のエージェント上で行われます。

クイックスタート（ローカル）

pnpm install
cp .env.example .env              # fill DATABASE_URL, ENCRYPTION_KEY, PUBLIC_API_URL
pnpm --filter @scopeprofit/contracts run build
pnpm run db:migrate
pnpm --filter @scopeprofit/api run build
pnpm --filter @scopeprofit/api run mcp:keys create --email <your-email> --label local
pnpm run dev:api                  # MCP endpoint at http://localhost:3001/api/mcp
pnpm run dev:landing              # landing at http://localhost:3000

その後、docs/mcp.md の説明に従ってクライアントを接続します（ChatGPT、Claude、Claude Code、Cursor、OpenAI Responses API、MCP Inspector、生のHTTP）。

ChatGPT向けセルフホスト

docs/self-host-chatgpt.md に記載されている、オプトイン方式のHTTPSオーバーレイとホスト主導のドラフト作成設定を使用してください。MCP／OAuthサーバーはすでにありますが、カスタムChatGPT接続の作成には、対象となるアカウント／ワークスペースと、検証済みの稼働中エンドポイントが必要です。セルフホストを希望しない場合は、上記のホスト型公開インスタンスと公式MCP Registryへの登録を利用できます。

一般的な流れ

1. create_project → クライアントの言葉と画像URLを指定して add_client_input を実行します。
2. ホスト側のLLMが update_scope_section でスコープを作成します（各要件には保存済みメッセージの引用が必要です）。または、サーバーエージェントがバックグラウンドで作成します（analyze: true。オーナーのGeminiキーが必要です）。
3. get_tldr／list_pending_questions → 見積もりを妨げるものがなくなるまで answer_question を実行します。
4. get_scope_document でテンプレート7.1を確認 → approve_scope（確認済みのバージョンをロックします。承認によってクライアントにメールが送信されることはありません）→ export_document で署名付きダウンロードリンクを生成して共有します。

開発者向け（製品）

ScopeProfit は MCP クライアントを通じて使用するもので、Web UI はありません。ChatGPT、Claude、Cursor、Claude Code、または独自のエージェントから操作します。

最速の方法（ホスト型、インストール不要）： https://scopeprofit-mcp.franutn23.workers.dev/api/mcp を ChatGPT または Claude のコネクターとして追加して認証します。OAuth の同意画面で API キーを一度入力します。また、公式 MCP Registry に io.github.FranprzDev/scopeprofit として登録されています。ホスト型インスタンスの API キーを取得するには、このリポジトリで issue を作成してください。例を含む接続ガイド全文はこちらです：scopeprofit.vercel.app/docs。

1. インストール運用者から API キーを取得します：pnpm --filter @scopeprofit/api run mcp:keys create --email [email protected] --label <client>。
2. ホストを接続します。クライアントごとの設定例（ChatGPT OAuth、Claude コネクター、Claude Code ヘッダー、Claude Desktop／Cursor 用のローカル stdio）は docs/mcp.md にあります。
3. 一般的なフロー：create_project → add_client_input → list_pending_questions に回答 → update_scope_section で下書きを作成 → approve_scope → export_document → save_quote → export_quote → decide_quote。8 回の呼び出しで完了するクイックスタートとエラーコード一覧は、docs/mcp.md をご覧ください。

クライアントポータルもメール配信機能もありません。エクスポートした PDF／DOCX を確認し、署名済みリンクを自分でクライアントと共有して、decide_quote でクライアントの回答を記録します。

技術スタック

• API： NestJS 11（Node 22、TypeScript）、Prisma 6 + PostgreSQL 17
• MCP： xmcp 1.9（ファイルベースのツール、Streamable HTTP + stdio）と既存の OAuth 2.1 認可サーバー
• エージェント（任意）： Gemini を使用した LangGraph + LangChain JS。確認ゲートには Vercel AI Gateway を使用
• ドキュメント： 構造化 Brief → Markdown、pdfkit → PDF、docx → DOCX
• ボット： secret_token を使用する grammY webhook
• 品質： 実際の PostgreSQL 上で実行するユニット、統合、MCP（xmcp HTTP 経由の SDK クライアント）、e2e（HTTP、OAuth、stdio）テスト。バックエンドとランディングページの CI パイプラインは別々に実行
• デプロイ： PostgreSQL と永続ボリュームを使用する Docker Compose

コマンド

pnpm --filter @scopeprofit/api run lint
pnpm --filter @scopeprofit/api run typecheck
pnpm --filter @scopeprofit/api run test        # unit + integration + mcp + e2e (needs DATABASE_URL)
pnpm --filter @scopeprofit/api run build
pnpm --filter @scopeprofit/api run mcp:stdio   # local stdio server (needs SCOPEPROFIT_API_KEY)
pnpm run production:preflight

バージョンの状況

• v1 — 提供済み： プロジェクト、構造化されたバージョン管理 Brief、AI エージェント、テンプレート 7.1、PDF／DOCX、承認と配信。
• v2 — 提供済み： Brief の差分、変更依頼ログと分類、厳密なドメイン型。
• v3（価格設定、見積もり、メンテナンス）— 提供済み： 見積もりと料金表は MCP ツール（save_quote、get_quote、export_quote、decide_quote）です。メンテナンス記録は内部に保持されます。
• MCP ファースト — このリリース： MCP サーバー、API キー、ChatGPT／Claude コネクター用 OAuth、署名付きエクスポート。Web アプリを削除し、ランディングページを書き換えました。

ドキュメント

• scopeprofit.vercel.app/docs — 開発者向けドキュメント（接続方法、例付きの 20 個のツール、フロー、制限事項）。AI エージェント向けの /llms.txt も同じサイトにあります
• docs/scope-to-profit.md — 製品のコンセプト、スコープ、アーキテクチャ（信頼できる唯一の情報源）
• docs/mcp.md — MCP ツール、認証、クライアントのセットアップ
• docs/technical-plan.md — v1 の当初の技術計画（履歴資料。ここで説明されている Web クライアントは削除済み）
• docs/production-launch-checklist.md — 本番環境向けチェックリスト