Folderr MCP

Folderr MCP服务器

一种模型上下文协议（MCP）服务器，提供与Folderr的API交互的工具，专门用于管理和与Folderr助手通信。

安装

添加到MCP设置

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

特性

服务器提供以下工具：

认证

支持两种身份验证方法：

1. 使用电子邮件/密码登录

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

1. API令牌身份验证

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

API令牌可以从Folderr开发者部分生成。建议将此方法用于自动化或长时间运行的流程。

助理管理

1. 列表助理

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

返回经过身份验证的用户的所有可用助手的列表。

1. 询问助理

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

向特定助理发送问题并收到他们的回复。

配置

服务器将其配置存储在 config.json 文件，其中包括：

• 文件夹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 带有Folderr的开发者部分中的API令牌的工具

1. 身份验证令牌会自动保存并用于后续请求
2. 所有与助手相关的工具在使用前都需要身份验证

错误消息

常见错误信息及其含义：

• “未登录”：未设置身份验证令牌
• “登录失败”：凭据无效
• “列出助手失败”：检索助手列表时出错
• “询问助手失败”：向助手发送问题时出错