MCP（Model Context Protocol）は、AIアプリケーションと外部ツール・データソースを統一されたインターフェースで接続するためのオープンスタンダードです。いわばAI版の「USB」——USBがあらゆる周辺機器をプラグアンドプレイで使えるように、MCPはAIがさまざまな外部サービスを統一的に呼び出せるようにします。
MCP がない場合、AIアシスタントは会話の内容に基づいた回答しかできません。MCP を導入すれば、QoderWork がカレンダーの操作、ドキュメントの検索、地図情報の取得などを直接行えるようになり、本当に「手を動かせる」アシスタントへと進化します。
仕組み
MCP はクライアント・サーバーモデルを採用しています：
- MCP クライアント — QoderWork 自体です。リクエストを送信し、結果を表示します。
- MCP サーバー — 各サービスプロバイダー（Firecrawl、Slack など）がデプロイし、具体的な操作を実行してデータを返します。
QoderWork で要望を伝えると、AIが自動的に適切な MCP サービスの呼び出しが必要かどうかを判断し、プロトコルを通じて実行、結果を表示します。いつも通り自然言語で話しかけるだけで大丈夫です。
MCP サーバーの追加
QoderWork デスクトップアプリを開き、Settings → MCP Servers に移動します。右上の + Add をクリックすると、2つの追加方法が表示されます。
Paste JSON Config
MCP マーケットプレイスから JSON 設定をそのままコピーできる場合に最適な方法です。
- + Add → Paste JSON Config をクリックします。
- ダイアログに MCP マーケットプレイスからコピーした JSON 設定を貼り付けます。
- Import をクリックして完了です。
JSON 設定のフォーマット例：
{
"mcpServers": {
"service-name": {
"type": "streamable-http",
"url": "https://mcp-server-url.example.com/sse",
"headers": {
"Authorization": "Bearer your-token"
}
}
}
}
Fill in Config Manually
手動で各項目を入力したい場合は、+ Add → Fill in Config Manually をクリックします。表示される「Add MCP Server」ダイアログで、まず Server Type のドロップダウンからタイプを選択します。タイプごとに異なる設定フォームが表示されます：
Streamable HTTP / SSE
URL 経由でアクセスするリモートホスティングの MCP サービス向けです。MCP マーケットプレイスで提供されるサービスの大半がこのタイプで、設定がシンプルなため、まずはこちらの利用をおすすめします。
- Server Name — 識別しやすい名前を付けます。
- Server URL — MCP マーケットプレイスからコピーした URL を貼り付けます。
- Headers（任意） — 認証が必要な場合、+ Add Header で手動入力するか（例：
Authorization: Bearer your-token）、Paste でクリップボードから一括インポートします。
Streamable HTTP は SSE のアップグレード版で、より高機能です。MCP マーケットプレイスが Streamable HTTP URL を提供している場合は、Streamable HTTP タイプを選択してください。
STDIO
コマンドラインで起動するローカル実行の MCP サーバー向けです。ローカルツールや CLI 連携を利用する開発者に適しています。対応するランタイム（Node.js、Python など）が事前にインストールされている必要があります。
- Server Name — 識別しやすい名前を付けます。
- Command — 完全な起動コマンドを貼り付けます（例：
npx -y @modelcontextprotocol/server-filesystem）。
- Environment Variables（任意） — サービスの実行時に必要な環境変数（API キー、アクセストークンなど）。+ Add Variable でキーと値のペアを個別に追加するか、Paste でクリップボードから一括インポートします。
入力が完了したら Add をクリックします。
Paste JSON Config と Fill in Config Manually、どちらを選ぶ？ JSON を貼り付けると、タイプ・URL・認証情報などすべてが一度に解析されます。手動入力は項目ごとにきめ細かく設定できます。最終的な結果は同じなので、使いやすい方を選んでください。
MCP サーバーの管理
追加したサーバーは MCP Servers ページの Custom Servers に表示されます。ここでは以下の操作ができます：
- スイッチでサーバーの有効・無効を切り替える。
- サーバーを展開して提供されるツールの一覧を確認する。
- 編集アイコンで設定を変更、または削除アイコンでサーバーを削除する。
ページ下部の Built-in Servers セクションには、QoderWork にプリインストールされた MCP サーバー（Browser、Notion、Linear など）が表示されます。同様にスイッチで有効・無効を切り替えることができます。
実践ガイド：Firecrawl MCP サーバーの接続
Firecrawl MCP サーバーを例に、MCP マーケットプレイスからサービスを取得して QoderWork で利用するまでの流れを説明します。Firecrawl MCP を追加すると、Web ページのスクレイピング、Web サイトのクロール、構造化データの抽出などを QoderWork から直接行えるようになります。
ステップ 1：MCP マーケットプレイスから設定を取得
- ブラウザで mcp.so にアクセスします。
- Firecrawl を検索し、サーバーの詳細ページを開きます。
- 説明やサポートされているツール一覧を確認し、用途に合っているかチェックします。
- ページ上の JSON Config ブロックを見つけ、Copy をクリックして設定をクリップボードにコピーします。
コピーされる内容は以下のようなフォーマットです：
{
"mcpServers": {
"firecrawl-mcp": {
"command": "npx",
"args": ["-y", "firecrawl-mcp"],
"env": {
"FIRECRAWL_API_KEY": "fc-your-api-key"
}
}
}
}
Firecrawl を利用するには API キーが必要です。firecrawl.dev でサインアップしてキーを取得し、設定の env フィールドに設定してください。 ステップ 2：QoderWork に追加
- QoderWork デスクトップアプリを開き、Settings → MCP Servers に移動します。
- + Add → Paste JSON Config をクリックします。
- ダイアログにコピーした JSON 設定を貼り付けます。
- Import をクリックします。
追加完了後、サーバーは Custom Servers セクションに表示されます。サーバー名の左に緑色のドットが表示されていれば、接続に成功しています。展開するとそのサービスが提供するツール一覧を確認できます。
ステップ 3：接続の動作確認
QoderWork の会話で実際にサービスを呼び出してみましょう：
QoderWork が MCP サーバーを正常に呼び出して結果が返ってくれば、接続成功です。
よくある質問
Q：追加した MCP が動作しない場合は？
以下の点を順番に確認してください：
- JSON 設定や URL が完全にコピーされていて、フォーマットが正しいか確認する。
- ネットワーク接続が正常か確認する（一部の MCP は特定のネットワーク環境が必要です）。
- 対象のサービスが追加の認証やログイン操作を必要としていないか確認する。
- MCP Servers ページでサーバーを削除してから再度追加してみる。
Q：MCP の呼び出しに遅延がある場合は？
MCP サービスの応答時間はサービスプロバイダーに依存します。ほとんどのサービスは数秒以内に結果を返します。タイムアウトが続く場合は、ネットワーク環境を確認するか、サービスプロバイダーにお問い合わせください。 
