フォルダMCPサーバー

Folderr の API と対話するためのツール、特に Folderr アシスタントの管理と通信を提供するモデル コンテキスト プロトコル (MCP) サーバー。

インストール

MCP設定に追加する

{
  "mcpServers": {
    "folderr": {
      "command": "npx",
      "args": ["-y", "@folderr/folderr-mcp-server"]
    }
  }
}

Related MCP server: Filesystem MCP Server

特徴

サーバーは次のツールを提供します。

認証

次の 2 つの認証方法がサポートされています。

1. メールアドレス/パスワードでログイン

   {
     "name": "login",
     "arguments": {
       "email": "user@example.com",
       "password": "your-password"
     }
   }

2. APIトークン認証

   {
     "name": "set_api_token",
     "arguments": {
       "token": "your-api-token"
     }
   }

   APIトークンはFolderr開発者セクションから生成できます。この方法は、自動化されたプロセスや長時間実行されるプロセスに推奨されます。

アシスタントマネジメント

1. リストアシスタント

   {
     "name": "list_assistants",
     "arguments": {}
   }

   認証されたユーザーが利用できるすべてのアシスタントのリストを返します。

2. アシスタントに質問

   {
     "name": "ask_assistant",
     "arguments": {
       "assistant_id": "assistant-id",
       "question": "Your question here"
     }
   }

   特定のアシスタントに質問を送信し、回答を受け取ります。

構成

サーバーは、次の内容を含む構成をconfig.jsonファイルに保存します。

• Folderr API のベース URL

• 認証トークン（ログインまたはAPIキーから）

エラー処理

サーバーは、一般的なシナリオに対して詳細なエラー メッセージを提供します。

• 認証失敗

• 無効なリクエスト

• APIエラー

• ネットワークの問題

発達

サーバーを構築するには:

npm install
npm run build

MCP設定での使用

MCP 設定構成に以下を追加します。

{
  "mcpServers": {
    "folderr": {
      "command": "node",
      "args": ["/path/to/folderr-server/build/index.js"]
    }
  }
}

認証フロー

1. どちらか：

   • メールアドレスとパスワードでloginツールを使用する

   • Folderrの開発者セクションからAPIトークンを使用してset_api_tokenツールを使用する

2. 認証トークンは自動的に保存され、後続のリクエストに使用されます。

3. すべてのアシスタント関連ツールは使用前に認証が必要です

エラーメッセージ

一般的なエラー メッセージとその意味:

• 「ログインしていません」: 認証トークンが設定されていません

• 「ログインに失敗しました」: 資格情報が無効です

• 「アシスタントのリストを取得できませんでした」: アシスタントリストの取得中にエラーが発生しました

• 「アシスタントに質問できませんでした」: アシスタントに質問を送信中にエラーが発生しました