x-cli 用于通过命令行执行 X/Twitter API v2 操作；x-mcp 仅在配置或运行 MCP stdio 服务器时使用。
发现命令：从内置参考开始，可运行 x-cli --help、x-cli <group> --help、x-cli --llms、x-cli --llms-full、x-cli <command> --schema。调用不熟悉的命令前先用 --schema；需要结构化输出时优先使用 --json 或 --format json。
认证与权限：针对账号的操作前检查 x-cli auth status 与 x-cli config show。auth status 显示令牌是否有效、过期、可刷新及已授予的 OAuth 范围；config show 显示只读或读写模式。写入操作需要读写模式和对应的写入范围（如 tweet.write、like.write、bookmark.write）。未登录时运行 x-cli auth login；用户明确要求写入时可用 x-cli auth login --read-write 与 x-cli config mode read-write，之后用 x-cli config mode read-only 回到更安全的只读模式。
安全默认：默认使用读取命令，如 tweet get、tweet search、tweet thread、tweet context、user get、user timeline、user followers、user following、me mentions、me bookmarks。可用 --limit、--page-size、--cursor、--offset 分页，用 --filter-output data.text、--token-limit、--token-offset 精简大输出。写入命令（tweet post/delete/reply/quote、me bookmark/unbookmark、like、retweet）仅在用户明确要求该操作且确认读写模式与范围后执行。程序化回复、点赞、收藏和指标可能受用户当前 X API 套餐与应用权限限制；遇到权限、层级或速率限制错误应明确报告，不要激进重试。
MCP：配置 MCP 使用 x-mcp，而非裸 x-cli，例如运行 x-mcp mcp add 或 x-mcp。无参数的 x-cli 打印 CLI 帮助；裸 x-mcp 启动 MCP stdio 服务器并等待消息。可从普通 CLI 模式导出本地认证供 MCP 环境使用：x-cli auth export json、x-cli auth export codex、x-cli auth export claude。导出内容含 OAuth 凭据与刷新令牌，不要粘贴到公开 issue、日志或模型可见记录；优先通过 X_CLI_AUTH_JSON 或客户端管理的密钥库传递。可用 x-cli auth import '<one-line-auth-json>'、x-cli auth import "$(x-cli auth export json)"、x-cli auth import --file x-cli-auth.json 或管道恢复；作为参数传 JSON 时要加引号。可用 x-cli auth import --mode read-only 强制更安全的本地模式；仅在用户明确要求写入且导入令牌范围包含所需写入范围时使用 --mode read-write。
限制：具体 X API 套餐、应用权限、速率限制与可用字段可能影响功能；资料未提供价格、平台与确切效果信息。