MCP-APIの使い方
LaunchfyのMCP-APIを使うと、Claude CodeやCodexなどのAIに、チーム内のアプリの問い合わせ対応やヘルプの更新を依頼できます。 PROプランで利用できます。
機能概要
| 機能 | AIに依頼できること |
|---|---|
| アプリの確認 | チーム内のアプリ一覧と各アプリの対応言語を確認する |
| 問い合わせ対応 | 未解決の問い合わせを一覧表示し、やり取りや添付画像を確認して、未送信の返信案を登録する 安全のため、AIは直接返信できないようになっています。AIが返信案を作成し、人が送信する形になります。 |
| ドキュメント | ヘルプや規約などのページを読み、既存ページの更新案を未公開の下書きとして保存する 安全のため、AIが直接更新できないようになっています。AIが更新案を作成し、人が公開する形になります。 |
| FAQ | カテゴリとFAQを確認し、カテゴリの追加・名称変更や、FAQの追加・編集・削除を行う FAQは直接更新可能です。FAQは一件の内容が小さいこともあり、直接更新可能にしています。 |
1. 準備
MCP用トークンを発行する
- Launchfyのアプリ管理画面を開き、チームメニューから MCP-API設定 を選びます。
- MCP APIトークン の トークンを発行 を押します。トークンは発行時に一度だけ表示されるので、安全な場所に保管してください。
- 設定画面に表示される接続先URLを控えます。末尾の
?teamId=...まで含めてコピーしてください。以下のhttps://example.com/api/mcp?teamId=YOUR_TEAM_IDは、そのURLに置き換えます。
トークンで接続すると、チーム内のすべてのアプリが操作対象になります。トークンはAIへのプロンプトや共有ファイルに貼り付けず、クライアントを起動する環境で LAUNCHFY_MCP_TOKEN に設定してください。再発行 すると古いトークンは使えなくなるため、接続済みのクライアントも更新してください。
Claude Codeで接続する
利用するプロジェクトの .mcp.json に以下を追加します。すでに mcpServers がある場合は、その中に launchfy の項目を追加します。
{
"mcpServers": {
"launchfy": {
"type": "http",
"url": "https://example.com/api/mcp?teamId=YOUR_TEAM_ID",
"headers": {
"Authorization": "Bearer ${LAUNCHFY_MCP_TOKEN}"
}
}
}
}
環境変数を設定したターミナルからClaude Codeを起動し、/mcp で launchfy の接続状態を確認します。初回にプロジェクトのMCP設定の承認を求められたら、接続先を確認して許可してください。 Claude CodeのMCP設定ガイド
Codex CLIで接続する
接続先URLを置き換え、ターミナルで次のコマンドを実行します。
codex mcp add launchfy \
--url 'https://example.com/api/mcp?teamId=YOUR_TEAM_ID' \
--bearer-token-env-var LAUNCHFY_MCP_TOKEN
codex mcp list で登録を確認できます。実際の接続を確認するには、環境変数を設定したターミナルからCodexを起動し、「Launchfyで管理しているアプリの名前とIDを一覧にして」と依頼します。Claude Codeでも同じ依頼で動作を確認できます。 CodexのMCP設定ガイド
2. 各機能の使い方
問い合わせを確認し、返信する
まず未解決の問い合わせを一覧にし、対応する問い合わせを選びます。
Launchfyで「アプリ名」の未解決の問い合わせを新しい順に5件確認してください。
問い合わせID、要点、AI返信案の有無を一覧にしてください。
続けて、対象の問い合わせIDを指定します。返信前に本文や過去のやり取りを確認し、必要に応じて添付画像も参照できます。
「アプリ名」の問い合わせ「問い合わせID」のやり取りを確認してください。
返信に必要なら添付画像も確認し、問い合わせと同じ言語で返信案を作ってください。
確認できていない原因や対応時期は断定せず、必要に応じて追加情報を尋ねてください。
返信案をここに表示し、私が承認したらLaunchfyに登録して、確認画面のURLを教えてください。
すでにAI返信案がある場合は、上書きする前に確認してください。
AIが返信案を登録すると、問い合わせ詳細に AI返信案 が表示されます。AIが返したURLを開き、返信欄へ反映 を押して、必要に応じて文面を直します。利用者への返信は、管理画面で 送信 を押した時点で行われます。
ドキュメントの更新案を作る
AIは既存ページを読み取り、Markdownの更新案を下書きとして保存できます。保存後は、AIが返した確認画面から内容を確認して公開します。
「アプリ名」のヘルプページ一覧から、通知設定を説明しているページを探してください。
既存の手順を確認し、「通知が届かないとき」の節を追加する案を作ってください。
私が承認したら下書きとして保存し、確認画面へのリンクを教えてください。
既存の下書きがある場合は、上書きする前に確認してください。
FAQを確認・更新する
FAQの追加・編集・削除は登録内容に反映されるため、変更案を先に確認してから実行を依頼すると安心です。
「アプリ名」のFAQを確認し、「通知が届かない」という質問がすでにないか調べてください。
重複していなければ、追加先のカテゴリと質問・回答の案を示してください。
私が承認してから、そのカテゴリにFAQを登録してください。