您需要什么
让助手登录有两种方式。请选择您的客户端支持的那一种。
通过浏览器授权连接
无需先在 Alforse 中做任何设置。您在助手中添加服务器 URL，Alforse 会请您批准这次连接。连接能做什么
- 它以您的身份、在您选择的公司中操作，权限恰好是您当前的权限。如果您的权限发生变化，助手的权限随之变化。
- 一旦您不再是该公司的启用成员，它就会停止工作。
- 公司和用户始终来自连接本身。助手无法通过传入不同的参数来切换公司或冒充他人。
登录在幕后如何运作
客户端会自动处理这些；此处的细节供自行开发客户端的开发者参考。- 授权类型：
authorization_code和refresh_token。响应类型：code。 - 使用
S256的 PKCE。公共客户端（令牌端点认证方式为none）必须发送 code challenge。 - 令牌端点的客户端认证：
client_secret_post或none。 - 范围：
mcp:tools。 - 授权码有效期为 10 分钟，且只能使用一次。访问令牌有效期为一小时（
expires_in: 3600）；客户端用其刷新令牌续期。
使用 API 密钥连接
对于无法打开浏览器登录的客户端以及脚本，请使用密钥。管理员在设置 → API密钥下创建它；密钥有自己的权限范围，并且属于一家公司。创建和限定密钥的方法请参阅 API 密钥。 把密钥放在Authorization 请求头中发送：
alforse-key: alf_your_key_here 请求头。
客户端配置
.cursor/mcp.json，或合并到您现有的 mcpServers）
.vscode/mcp.json；VS Code 会向您索要密钥，因此不会保存在文件中）
https://app.alforse.com/api/mcp 和 Authorization: Bearer … 请求头。URL 字段的名称因客户端而异（例如 url 或 serverUrl）；请查阅您的客户端文档。
助手看到的工具
服务器没有为每个操作提供一个工具，而是提供三个可以触达所有操作的工具：
这些操作来自以下领域：账户、会计、文档、库存、开票、物料、人员、生产、采购、质量、资源、销售、设置、共享和用户。只有 Alforse 明确发布的操作才可用；有些被有意排除在服务器之外。
- 每次调用都经过与应用相同的权限检查，写入由同一服务层校验。
- 每个操作都带有风险等级，因此您的助手可以在运行
WRITE或DESTRUCTIVE操作之前先询问您。 - 列表读取默认返回 25 行。助手通过
limit（1–100）和offset翻页。 - 助手会获知贵公司时区下的今天日期，因此“上周”这类相对日期能被正确解析。
限制
达到限制时，服务器会以
429 响应，并附带 Retry-After 以及 X-RateLimit-Limit、X-RateLimit-Remaining 和 X-RateLimit-Reset 请求头。请等待 Retry-After 指定的秒数，然后重试。