Folderr MCP 服务器
模型上下文协议 (MCP) 服务器提供与 Folderr 的 API 交互的工具,专门用于管理和与 Folderr 助手通信。
安装
添加到您的 MCP 设置
{
"mcpServers": {
"folderr": {
"command": "npx",
"args": ["-y", "@folderr/folderr-mcp-server"]
}
}
}
特征
该服务器提供以下工具:
验证
支持两种身份验证方法:
- 使用电子邮件/密码登录
{
"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 密钥)
错误处理
服务器提供了常见场景的详细错误信息:
发展
构建服务器:
npm install
npm run build
在 MCP 设置中的使用
将以下内容添加到您的 MCP 设置配置中:
{
"mcpServers": {
"folderr": {
"command": "node",
"args": ["/path/to/folderr-server/build/index.js"]
}
}
}
身份验证流程
- 任何一个:
- 使用电子邮件和密码
login
工具 - 使用
set_api_token
工具和来自 Folderr 开发者部分的 API 令牌
- 身份验证令牌会自动保存并用于后续请求
- 所有与助手相关的工具在使用前都需要身份验证
错误消息
常见错误信息及其含义:
- “未登录”:未设置身份验证令牌
- “登录失败”:凭证无效
- “无法列出助手”:检索助手列表时出错
- “无法询问助手”:向助手发送问题时出错