乐乐销售 MCP服务器

这是一个MCP服务器，基于乐乐销售(RAKUS)的API集成手册(2025/02, 第15版)，使以下API可以通过Claude的"自定义连接器"进行调用。

• 文件上传 / CSV文件导入 / CSV数据导入 / CSV导入状态确认 / CSV导出

• 记录注册 / 更新 / 删除 / 参照

事前准备(乐乐销售 侧)

1. API集成选项合同 ＋ IP访问限制设置是必需的(手册第1章・第5章)。 请在管理员设置＞安全设置标签页＞IP访问限制相关设置中，允许部署目标服务器的发送源IP。 (对于Render等没有固定IP的PaaS，可能需要使用静态Outbound IP附加组件)

2. 在用户设置画面中发行并确定API令牌(手册第3章)。

3. 各DB的"dbSchemaId""importId""项目ID"等，请从管理员设置＞维护功能标签页＞API参数信息中确认。

部署步骤(Render・详细版)

为初次使用PaaS的用户，我们将从push到GitHub到连接Claude的一整套流程整理在 RENDER_DEPLOY.md 中。请先查看此文件。 支持使用 render.yaml 的Blueprint部署。

要点如下:

1. 将此文件夹push到GitHub仓库

2. 在Render中通过Blueprint(render.yaml)创建Web Service(套餐为starter以上)

3. 在环境变量中设置 RAKURAKU_DOMAIN / RAKURAKU_ACCOUNT / RAKURAKU_API_TOKEN / MCP_SHARED_SECRET

4. 在Settings画面中启用"Static Outbound IP Addresses"，并将显示的固定IP注册到乐乐销售的IP访问限制中

5. 将 https://<デプロイ先>.onrender.com/mcp 注册为Claude的连接器URL

在Render以外(Railway / Fly.io / 自建VPS + PM2 等)的环境中，只要Node.js 18以上能运行，也可以用同样的步骤部署。

Claude侧的连接器设置

1. 在Claude.ai的设置画面中打开"添加自定义连接器"。

2. 输入各项目。

   • 名称: 任意(例: 乐乐销售)

   • 远程MCP服务器URL: https://<デプロイ先>/mcp

   • OAuth Client ID / Secret: 留空即可(因为此服务器采用简易的共享密钥方式)

3. 如果设置了 MCP_SHARED_SECRET，请设置连接器使其能够发送标头 Authorization: Bearer <MCP_SHARED_SECRET> (在当前的Claude.ai自定义连接器UI中，有时无法直接指定附加标头。此时可以将 MCP_SHARED_SECRET 留空使用，或通过IP访问限制和自定义认证中间件进行保护)。

4. 点击"添加"进行连接。

本地运行确认

npm install
cp .env.example .env
# .env を編集して RAKURAKU_DOMAIN / RAKURAKU_ACCOUNT / RAKURAKU_API_TOKEN を設定
npm start

从另一个终端进行连通性确认:

curl -X POST http://localhost:3000/mcp \
  -H "Content-Type: application/json" \
  -H "Accept: application/json, text/event-stream" \
  -d '{"jsonrpc":"2.0","id":1,"method":"initialize","params":{"protocolVersion":"2025-06-18","capabilities":{},"clientInfo":{"name":"test","version":"1.0"}}}'

提供的工具列表

注意事项

• 在记录注册/更新API等的 values 中指定的项目ID(例: "105110")因DB而异。请事先在"API参数信息"画面中确认， 并告知Claude"此DB的项目ID是〇〇"后再请求操作。

• 乐乐销售API有每分钟20次请求的限制(手册第5章)。处理大量数据时请注意。

• 请不要将 RAKURAKU_API_TOKEN 分享给第三方。建议使用部署目标的环境变量(Secret)功能，不要直接写在代码或Git仓库中。