使用说明
@rynko/mcp服务器
用于Claude Desktop的Rynko MCP服务器-通过自然对话管理模板和生成文档。
安装
选项1:一键安装(推荐)
即将推出:直接从Claude Desktop Extensions目录安装。
或从安装 .mcpb 捆绑:
- 下载
rynko-mcp-{version}.mcpb从 发布页面 - 在Claude Desktop中,转到 设置 → 扩展
- 点击 从文件安装 并选择已下载的
.mcpb文件 - 出现提示时输入您的个人访问令牌
- 完成!开始和克劳德谈论你的文件。
选项2:NPX(手动设置)
全局安装:
npm install -g @rynko/mcp-server
或者直接与npx一起使用(推荐):
npx @rynko/mcp-server
手动设置
1.获取个人访问令牌(PAT)
- 登录到您的 Rynko仪表板
- 首选 设置 → 个人访问令牌
- 点击 创建令牌
- 输入标签(例如“Claude Desktop”)
- 选择到期日(最长30天)
- 复制令牌-它不会再显示!
2.配置克劳德桌面
添加到您的Claude Desktop配置文件中:
macOS: ~/Library/Application Support/Claude/claude_desktop_config.json
视窗: %APPDATA%\Claude\claude_desktop_config.json
{
"mcpServers": {
"rynko": {
"command": "npx",
"args": ["-y", "@rynko/mcp-server"],
"env": {
"RYNKO_USER_TOKEN": "pat_xxxxxxxxxxxxxxxx"
}
}
}
}
3.重新启动克劳德桌面
关闭并重新打开Claude Desktop。您应该在可用的MCP服务器中看到“rynko”。
可用工具
工作区工具
| 工具 | 说明 |
|---|---|
list_workspaces |
列出您有权访问的所有工作区 |
get_workspace |
获取特定工作空间的详细信息 |
模板工具
| 工具 | 说明 |
|---|---|
list_templates |
列出工作区中的模板 |
get_template |
获取模板详细信息和架构 |
create_draft_template |
创建新的草稿模板 |
update_draft_template |
更新草稿模板 |
validate_schema |
验证模板架构 |
get_schema_reference |
获取模板架构文档 |
数据工具
| 工具 | 说明 |
|---|---|
parse_data_file |
将Excel或CSV数据解析为JSON |
map_variables |
自动将数据列映射到模板变量 |
生成工具
| 工具 | 说明 |
|---|---|
preview_template |
生成预览文档 |
generate_document |
生成生产文档 |
get_job_status |
检查文档生成状态 |
示例用法
配置后,您可以与Claude进行自然对话:
你: 使用公司徽标、客户详细信息和行项目表创建发票模板。
克劳德: 我会为你创造它。让我先检查一下你的工作区。..
[使用Rynko工具创建模板]
你: 为Acme Corp生成一张发票,其中包含3行项目,总计1500美元。
克劳德: 我现在就生成发票。..
[使用模板生成PDF]
环境变量
| 变量 | 必填 | 描述 |
|---|---|---|
RYNKO_USER_TOKEN |
是 | 您的个人访问令牌(以开头 pat_) |
RYNKO_API_URL |
否 | 自定义API URL(默认值: https://api.rynko.dev/api) |
安全
- 令牌到期:PAT最多在30天后到期
- 仅限草稿:通过MCP创建的模板在手动发布之前都是草稿
- 审计日志:所有操作都记录在团队的活动提要中
- 可撤销的:立即从您的仪表板中撤销令牌
故障排除
“无效令牌”错误
- 验证您的令牌以开头
pat_ - 检查令牌是否已过期
- 从仪表板生成新令牌
“连接失败”错误
- 检查您的互联网连接
- 验证Rynko API是否可访问
- 尝试重新生成PAT
Claude Desktop找不到服务器
- 检查配置文件JSON语法
- 确保
npx在你的路径中 - 完全重新启动克劳德桌面
文档
支持
- 电子邮件: support@rynko.dev
- 问题: GitHub问题
从源头构建
构建MCPB捆绑包
要构建Claude Desktop扩展包,请执行以下操作:
cd integrations/mcp-server
npm install
npm run build:mcpb
这将创建:
dist-mcpb/rynko-mcp-{version}.mcpb-扩展包dist-mcpb/rynko-mcp-{version}.mcpb.sha256-校验和文件
捆绑内容
rynko-mcp-{version}.mcpb
├── manifest.json # Extension metadata and configuration
├── server/ # Compiled server code
│ ├── index.js
│ └── client.js
└── icon.png # Extension icon (optional)
目录提交
要提交到Claude Desktop Extensions目录,请执行以下操作:
- 构建MCPB捆绑包:
npm run build:mcpb - 通过“从文件安装”进行本地测试
- 通过提交 Anthropic扩展提交表
- 包括:
- 扩展名和描述
- 隐私政策网址
- 服务条款URL
- 3+使用示例
- 安全注释(数据访问、网络访问)
许可证
麻省理工学院
