# 在 ChatGPT 中使用自己的 KazTool 账号

[Қазақша нұсқаулық](https://www.kaztool.cn/agent/chatgpt/kk) · [English guide](https://www.kaztool.cn/agent/chatgpt/en) · [本人连接中心](https://www.kaztool.cn/agent) · [开通与支持](https://www.kaztool.cn/agent/support) · [توتە جازۋ](https://www.kaztool.cn/agent/chatgpt/kk-arab)

KazTool 将哈萨克西里尔文与传统哈萨克文（托特叶文）双向转换。每个人连接自己的 KazTool 账号，消耗本人已有的字符额度。ChatGPT 使用账户授权（OAuth），无需创建或向聊天发送 API 密钥。

## 开始前：先检查 ChatGPT 的接入入口

截至 2026-10-11，OpenAI 说明 Free 包含 ChatGPT Work，但当前自定义 MCP 文档没有明确保证所有免费账号都能添加服务器，接入仍受账号和工作区权限影响。我们尚未完成独立 Free 账号实测，因此不能承诺免费版一定能接入。见[官方套餐说明](https://learn.chatgpt.com/docs/pricing)和[自定义 MCP 接入说明](https://developers.openai.com/api/docs/guides/custom-mcp-server)。

1. 先在电脑浏览器登录测试者自己的 ChatGPT，打开 Plugins，搜索 `KazTool Tote Assistant`，确认是否有可安装的公开条目。
2. 如果没有公开条目，检查加号菜单中是否有 `Add custom MCP server`，并打开表单，确认能够填写服务器地址和选择 OAuth。此时无需登录 KazTool 或完成授权。
3. 如果没有入口、按钮不可用，或界面要求升级/管理员批准，先停止并反馈提示；不要为试接入购买 ChatGPT 套餐或 KazTool 额度。能打开表单只说明可以开始，最终仍须实际安装、授权和调用验收。
4. 确认接入入口可用后，再继续下面的本人 KazTool 登录、人工 API 开通和额度核对步骤。

## 先确认你可以使用哪种入口

公开目录安装、私有测试连接和 KazTool 网站是不同入口。此指南不代表插件已审核通过或已上架。请先在 ChatGPT 的 Plugins／插件目录搜索 `KazTool Tote Assistant`；只有能看到公开条目时才按目录流程安装。

如果搜索不到，请勿购买 ChatGPT 套餐来期待自动获得此插件。审核期间，只有你的 ChatGPT 账号及工作区允许添加自定义 MCP 时，才可使用下面的测试连接流程。没有该入口时，可以先使用 KazTool 网站，等待公开发布。

## 1. 登录并开通你自己的账号

打开 [KazTool 连接中心](https://www.kaztool.cn/agent)。尚未登录时，点击“打开 KazTool 登录”，在新标签中完成本人登录，再回到原连接页面点“继续”。首次使用者按网站提供的登录方式建立本人身份；不要使用服务提供者或其他人的登录。

如果看到“已登录，请申请开通 API”，请通过该页支持入口提交页面显示的本人账户编号，等待运营核实并开通。当前 API 开通仍由人工处理；网站注册、网站 VIP 或 ChatGPT 订阅不会自动赠送 API 额度。开通后回到原页面点“刷新状态”。

开通后检查自己的账户尾号、试用剩余和已购剩余。试用资格与额度以本人页面实际显示为准，没有余额时不能完成转换。需要额度时，由本人在 KazTool 网站独立办理；不要要求 ChatGPT 购买、续费或打开支付页。网站 VIP 与 API 字符额度分开。

## 2. 在 ChatGPT 连接 KazTool

目录中已有公开条目时，打开 `KazTool Tote Assistant`，按页面的安装／连接按钮操作。账号、地区和工作区策略可能影响可用性；找不到按钮不代表 KazTool 已经完成公开发布。

自定义 MCP 测试入口：进入 ChatGPT 的 Plugins／插件页面，点加号并选择 `Add custom MCP server`（添加自定义 MCP 服务）。填写名称 `KazTool`、MCP 地址 `https://api.kaztool.cn/mcp`，使用 OAuth 账户授权。若页面提供 OAuth 客户端注册设置，选择自动注册；不要填写别人的客户端秘密或 API key。按页面说明检查权限并创建连接。 创建后，在个人 Plugins 中找到该连接，并按界面提示安装，再开始调用验收。

自定义 MCP 只连接四个服务工具，不等于安装带托特回复 Skill 的完整插件。界面位置与权限以当前 ChatGPT 实际显示为准。官方说明：[连接与测试](https://developers.openai.com/plugins/deploy/connect-chatgpt)。

## 3. 在 KazTool 页面确认本人授权

ChatGPT 跳转到 KazTool 后，先核对页面的账号尾号和余额是否属于自己。若账号不对，先在 KazTool 网站退出并登录正确账号，再从 ChatGPT 重新发起连接；不要同意错误账号的授权。

权限只有文字转换、文字系统检测、本人用量查询。授权有效期为 30 天，可提前撤销；不允许读取你的其他 KazTool 文档，不会获取其他用户的额度。你确认后点击“同意授权”，完成后返回 ChatGPT。选择“取消”不会建立新授权。

## 4. 用一条短文本验收

新开 ChatGPT 对话，输入 `@` 并选择已连接的 KazTool。先发送：

```text
请使用我已连接的 KazTool 查询当前额度。只查询，不转换；列出 characters_used、successful_requests、trial_characters_remaining 和 paid_characters_remaining。如果没有工具或认证失败，如实报告。
```

确认可用余额至少 5 字符后，再发送：

```text
请使用我已连接的 KazTool，只调用一次 convert_kazakh_script，把 бірақ 从 kk-Cyrl 转为 kk-Arab。按 converted_text 原样输出，保留 Hamza；另外列出 request_id、algorithm_version、warnings 和 usage 回执。不要改写、推测结果或自动重试。
```

之后再次查询用量。该单词有 5 个输入 Unicode 字符；成功转换应消费 5 字符，优先使用试用额度，其次使用本人可用已购额度。没有其他并发请求时，已用字符增加 5、成功请求增加 1。保存实际 request_id 和前后用量即可；不要分享密码、令牌或完整账号编号。

反向验收请复制第一次实际返回的 converted_text，再单独要求从 kk-Arab 转为 kk-Cyrl；先核对剩余额度足够。不要用双向总量一定等于 10 来判断，因为托特文 Hamza 也是一个输入字符。

## 额度和费用如何归属

同一 KazTool 账号的 OAuth 连接和 API 密钥共用本人额度；换客户端或建新密钥不会新增赠送额度。ChatGPT 订阅及 OpenAI API 余额不能抵扣 KazTool 字符；本服务计的是转换输入字符，不是模型 Token 或人民币。

成功转换与批量转换按输入 Unicode 字符计量，包含空格、标点和换行。检测与用量查询消耗 0 转换字符，但仍受速率限制。失败不扣转换字符；网络超时结果不确定时，先核对本人用量，不要自动重发转换。

## 常见问题与撤销

| 情况 | 下一步 |
|---|---|
| 没有公开目录条目，也没有自定义 MCP 入口 | 等待公开发布；无需向聊天提交密钥或重复购买订阅 |
| 未开通 API | 在本人连接中心提交本人编号申请人工开通，再回原流程刷新 |
| 登录后仍停在登录页 | 回到原连接页点“继续”；仍失败时检查同一浏览器的网站登录状态 |
| 认证失败、授权到期或已撤销 | 从 ChatGPT 重新连接并确认正确账号；不要通过创建密钥替代 OAuth |
| 额度不足 | 停止转换，检查本人额度；查询与连接管理仍可用 |
| 模型只给出文字，没有工具回执 | 尚未证明 KazTool 实际调用成功；选择连接后按验收提示检查 |
| 超时或用量对不上 | 停止重复调用，保留 request_id 和前后用量，通过支持页核实 |

打开 [本人连接中心](https://www.kaztool.cn/agent)，在“已授权连接”中撤销对应 ChatGPT 连接。撤销后新请求不能继续使用该授权；正在完成的请求不保证被取消。授权到期后重新连接，已有字符余额不会因重连自动重置。

KazTool 此接口只做文字系统转换、批量、检测和用量查询，不提供 OCR、语义翻译、语法校对或文档排版。模型生成答案与 KazTool 转换是两个步骤。API 接收到的文字由 KazTool 服务处理，不持久保存正文；ChatGPT 的聊天留存由其自身设置控制。

官方依据：[OAuth 认证](https://developers.openai.com/plugins/build/auth) · [审核与发布](https://developers.openai.com/plugins/deploy/submission)。公开安装与独立外部用户验收必须另有实际平台证据，网站指南可读不代表这些步骤已经完成。