让你的 Muse 使用 KazTool
用你自己的账号、密钥和字符额度，完成哈萨克语西里尔文与托特文转换。网站 VIP 与 API 字符额度独立；每位用户分别授权，不共享 KazTool 所有者的密钥。
更新：2026-10-11 · 接入包1.0.0 · Python 3.10+ · 无额外依赖。
1. 登录并申请开通
打开 本人连接中心，用自己的 KazTool 账号登录。已开通者能看到实时试用与已购字符、个人密钥和连接。
如果显示“请申请开通 API”，把页面上的本人账户编号提交给 申请开通与支持，运营开通后刷新。注册不会自动保证试用额度；不要提供密码或密钥。开通与充值是两个步骤，尚未开通时不能靠购买绕过账号绑定。
2. 下载公开接入包
包内只有 Skill、安装说明、Python MCP 客户端、公开连接信息和许可，不包含密钥、私人账号、转换算法或映射表。ZIP 校验值见清单，Muse 应先核对再解压。这是工作区安装包，不是 Muse 官方商店插件；connection.json 不是原生导入配置。
3. 将这段指令发给自己的 Muse
请读取 https://www.kaztool.cn/agent/muse.md 。从该页面下载 KazTool Muse 1.0.0 的 ZIP 和 manifest；核对 ZIP SHA-256、文件清单并检查内容。将 kaztool-muse 安装到我自己的 Muse 工作区技能目录，路径按当前环境确定。已有同名技能时先备份并展示差异，不覆盖私人配置，不安装全局依赖。
只使用我自己的 KazTool 账号、密钥和额度。我会在 https://www.kaztool.cn/agent 登录、申请开通并创建个人密钥。请提供 Muse 安全凭据表单，以 custom.kaztool 保存本人密钥，不能让我在聊天中粘贴密钥，不能将密钥写进代码、日志或普通配置文件。
如果已有安全认证的 KazTool MCP 连接，先发现真实工具并查我的用量。否则在运行环境支持安全凭据注入时，将本人密钥或其安全代理仅注入本次运行的 KAZTOOL_API_KEY，按包内 README 运行 python3 scripts/kaztool_mcp.py check。凭据只发往 https://api.kaztool.cn/mcp，不跟随重定向。
本次先安装、发现四个工具和查询本人额度，不执行收费转换、购买或充值。没有安全凭据表单、注入能力、Python 3.10+ 或调用工具时，准确报告缺少的能力，不假装连接成功。完成后报告已安装位置、实际 serverInfo、四个工具及本人实时用量；不显示凭据。Muse 7.0 的现有接入已验证安全凭据代理和远程 MCP 调用；不同用户的环境仍须各自检查。不假设有“一键导入 ZIP”按钮。安全表单必须由你的 Muse 实际提供；能力缺失时先停止并联系支持。
4. 创建本人密钥并安全授权
在 连接中心 创建个人 API 密钥，通常30天到期，完整密钥仅显示一次。仅填入 Muse 提供的安全凭据表单；不要贴聊天、源码、URL或截图。安全凭据名 custom.kaztool 是每位用户本地的别名，不代表共用一把密钥。
连接地址为 https://api.kaztool.cn/mcp，认证为安全配置的 Bearer 凭据。支持 OAuth 的客户端也须走本人账户授权；本教程的 Muse 包使用个人密钥路径，不承诺 Muse 原生 OAuth 兼容。
check 只查询用量，不扣字符。看到安装目录或文档不等于连接成功；必须得到真实工具列表和本人用量。密钥和 OAuth 连接共用本人账号余额，额度不会跟着安装包赠送或复制。
5. 小量验收四个工具
连接成功后，再把以下指令发给 Muse。至少需16个可用试用字符；暂停同账号其他转换，避免并发消耗。预查无法锁定试用余额，若并发请求导致已购扣减，应停止并如实报告。
请按已安装包的 README 验收真实 KazTool MCP 四工具。先查我的用量；试用不足16字符时停止报告，不默认用已购额度补测。
依次检测“бірақ”的文字系统；将“бірақ”从 kk-Cyrl 转为 kk-Arab；核对单段真实回执及试用余额，再批量转换两段：同一正向输入，以及把上一步实际 converted_text 从 kk-Arab 反向转换。最后再查用量。
用户确认的正向词形是“ءبىراق”，首字符 U+0621；反向是“Бірақ”（句首大写）。按真实 converted_text 输出，不自行改写字母、Hamza、空格或标点。
报告实际工具名、检测/单段/批量的三个 request_id、algorithm_version、warnings 和消耗回执。无其他请求时，累计应增加16字符、3成功请求，试用减少16、已购不变；用量查询不扣字符。不要伪造回执，网络结果不明不自动重试，发现失败或异常计量立即报告并停止。| 工具 | 参数 | 字符计量 |
|---|---|---|
get_kaztool_usage | {} | 0，不增加成功请求数 |
detect_kazakh_script | text | 0，成功请求数增加1 |
convert_kazakh_script | text、source_script、target_script | 按输入 Unicode 码点 |
batch_convert_kazakh_script | items，每项为转换参数 | 按全部输入码点，1个批量请求 |
只支持 kk-Cyrl ↔ kk-Arab。单段最多20,000码点；批量1–20段、总计100,000码点。空格、标点和换行同样计量。有限词形验收不证明所有文字准确；这不是语义翻译、OCR、语法校对或 Word/PDF 排版工具。
6. 使用本人额度，需要时自行购买
成功转换先用试用字符，再扣本人可用已购字符。用户可以打开 本人 API 额度页 查看实时价格、有效期和条款，自己确认购买；本包不会代购买或充值。网站会员与 API 额度独立，同账号多把密钥共用一份余额。
日常可让 Muse 转换你指定的文本，或先起草哈萨克语西里尔文再调用 KazTool 生成托特文回复。最终正文以工具的 converted_text 为准。新用户须完成自己的安装、开户、认证和真实调用；现有用户接通不等于所有人的 Muse 自动获得能力。
遇到问题
- 未开通：提交本人账户编号申请，开通后刷新；不要发送密钥。
- 401／密钥过期：在本人连接中心创建或更新密钥，仅在安全表单替换。
- 403：检查本人账号开通和权限；不要改用他人密钥。
- 额度不足：先看本人用量，再自行查看额度页；不要循环重试。
- 429：暂停并减少请求，所有调用仍受速率限制。
- 网络超时或回执无法解析：调用可能已经完成，先检查用量与现有回执。MCP不保证去重；仅用量差额不能证明完整转换结果，不自动重放。
- 卸载与撤销：在 Muse 自己的工作区移除 Skill；在本人连接中心撤销密钥。仅删除文件不等于撤销授权。
API 通用接入与隐私说明 · 申请开通与支持。凭据只发往 api.kaztool.cn；转换文本由 KazTool 服务处理，本服务不保存输入正文。客户端应按自己的环境管理聊天和输出记录。