Folderr

🚀 Folderr MCP サーバー

このサーバーは、Model Context Protocol (MCP) を使用して Folderr API とのインタラクションを可能にするツールを提供し、主に Folderr アシスタントの管理と通信に使用されます。

🚀 クイックスタート

このサーバーを使用するには、まず MCP 設定に追加する必要があります。

📦 インストール

以下の設定をあなたの MCP 設定に追加してください。

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

✨ 主な機能

サーバーが提供するツールは以下の通りです。

認証

2種類の認証方法をサポートしています。

基本的な使用法

メールアドレスとパスワードでのログイン

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

高度な使用法

APIトークンによる認証

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

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

アシスタント管理

基本的な使用法

アシスタントの一覧表示

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

認証されたユーザーに対して、利用可能なすべてのアシスタントのリストを返します。

高度な使用法

アシスタントに質問する

{
  "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 ツールを使用してメールアドレスとパスワードでログインする
   • set_api_token ツールを使用して API トークンを設定する（Folderr の開発者セクションから取得）
2. 認証トークンは自動的に保存され、以降のリクエストで使用されます。
3. すべてのアシスタント関連のツールは、使用前に認証が必要です。

エラーメッセージ

一般的なエラーメッセージとその意味は以下の通りです。