メインコンテンツへスキップ

Documentation Index

Fetch the complete documentation index at: https://docs.qoder.com/llms.txt

Use this file to discover all available pages before exploring further.

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つの追加方法が表示されます。
mcp

​
Paste JSON Config

MCP マーケットプレイスから JSON 設定をそのままコピーできる場合に最適な方法です。
  1. + Add → Paste JSON Config をクリックします。
  2. ダイアログに MCP マーケットプレイスからコピーした JSON 設定を貼り付けます。
  3. 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 マーケットプレイスから設定を取得

  1. ブラウザで mcp.so にアクセスします。
  2. Firecrawl を検索し、サーバーの詳細ページを開きます。
  3. 説明やサポートされているツール一覧を確認し、用途に合っているかチェックします。
  4. ページ上の 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 に追加

  1. QoderWork デスクトップアプリを開き、Settings → MCP Servers に移動します。
  2. + Add → Paste JSON Config をクリックします。
  3. ダイアログにコピーした JSON 設定を貼り付けます。
  4. Import をクリックします。
追加完了後、サーバーは Custom Servers セクションに表示されます。サーバー名の左に緑色のドットが表示されていれば、接続に成功しています。展開するとそのサービスが提供するツール一覧を確認できます。

​
ステップ 3：接続の動作確認

QoderWork の会話で実際にサービスを呼び出してみましょう： QoderWork が MCP サーバーを正常に呼び出して結果が返ってくれば、接続成功です。

​
よくある質問

Q：追加した MCP が動作しない場合は？ 以下の点を順番に確認してください：
  1. JSON 設定や URL が完全にコピーされていて、フォーマットが正しいか確認する。
  2. ネットワーク接続が正常か確認する（一部の MCP は特定のネットワーク環境が必要です）。
  3. 対象のサービスが追加の認証やログイン操作を必要としていないか確認する。
  4. MCP Servers ページでサーバーを削除してから再度追加してみる。
Q：MCP の呼び出しに遅延がある場合は？ MCP サービスの応答時間はサービスプロバイダーに依存します。ほとんどのサービスは数秒以内に結果を返します。タイムアウトが続く場合は、ネットワーク環境を確認するか、サービスプロバイダーにお問い合わせください。