API key và AI CLI
Kết nối hosted provider, AI CLI local và MCP integration mà không gửi workspace data lên cloud của 1MarketingTool.
1MarketingTool dùng mô hình BYOK. Bạn chọn provider muốn kết nối, và app dùng API key hoặc AI CLI local của chính bạn.
AI CLI được hỗ trợ
Ứng dụng có thể làm việc với các AI CLI phổ biến:
| CLI | Cách dùng thường gặp |
|---|---|
| Claude Code CLI | Viết và phân tích |
| Codex CLI | Coding, content và workflow có image |
| Gemini CLI | Content và workflow có image |
| OpenCode CLI | Agent workflow local |
| Kiro CLI | Agent workflow local khi có sẵn |
| Hermes | Được nhận diện sẵn trên macOS, Windows và Linux; chạy ở chế độ one-shot cho tạo nội dung, so sánh trong Prompt Explorer và các tác vụ AI cục bộ khác, có chọn model theo từng lần chạy |
Chỉ bật CLI bạn thật sự dùng. Nếu CLI chưa được cài, hãy để tắt cho đến khi nó có trên máy.
Hosted provider
Dùng hosted provider khi workflow cần dữ liệu ngoài hoặc model bạn muốn:
- OpenAI, Claude, Gemini hoặc provider AI khác cho generation.
- DataForSEO cho keyword, SERP, backlink và ranking data.
- Google Search Console và analytics services cho site performance.
- API của social channel để đăng bài theo lịch.
Model chạy trên máy của bạn
Bạn có thể trỏ route BYOK tới một model chạy ngay trên máy này hoặc trong mạng nội bộ thay vì dịch vụ hosted. Cách này dùng được với mọi server trả lời theo dạng OpenAI, như LM Studio, Ollama hay 1LocalAITool, và với server trả lời theo dạng Anthropic, mà 1LocalAITool cũng hỗ trợ.
- Mở Settings → AI và chuyển sang BYOK.
- Chọn Custom OpenAI-compatible trong Gateways, hoặc Anthropic trong Protocols nếu server của bạn dùng dạng Anthropic.
- Đặt Base URL thành địa chỉ server local in ra, ví dụ
http://localhost:1234/v1cho LM Studio hoặchttp://localhost:11434/v1cho Ollama, và đặt Model là id của model mà server đang chạy. - Nhập một giá trị bất kỳ vào API key. Ô này không được để trống, nhưng server local không kiểm tra key sẽ chấp nhận mọi giá trị.
- Bấm Test connection, rồi Use as active.
Model chạy trên CPU hoặc GPU nhỏ viết khá chậm, nên 1MarketingTool cho Base URL local tối đa mười phút để trả lời, trong khi provider hosted chỉ có 45 giây. Giới hạn dài hơn này áp dụng khi host của Base URL là localhost, địa chỉ 127.x, 10.x, 192.168.x hoặc 172.16–31.x, tên .local, hoặc địa chỉ Tailscale (100.64–127.x hay tên .ts.net). Custom OpenAI-compatible có giới hạn này từ 1.5.0, Anthropic từ 1.5.1. Nhờ vậy một campaign hay bài viết dài từ model local chậm sẽ chạy xong thay vì bị timeout giữa chừng.
Lưu key
API key và token nên được lưu trong phần settings của app. Publishing token được lưu qua keychain của hệ điều hành khi được hỗ trợ. Tránh paste secret vào prompt hoặc content field.
MCP integration
1MarketingTool mở các công cụ rank, keyword, content, video và browser qua một MCP server cục bộ duy nhất tên onemarketingtool. Dùng nó khi bạn muốn các AI client tương thích chạm tới quy trình riêng của ứng dụng ngay trên máy — xem MCP Integrations.
Khắc phục sự cố
Nếu provider lỗi, hãy xem lỗi cụ thể trong Logs hoặc màn hình settings liên quan. Phần lớn lỗi đến từ thiếu permission, token hết hạn hoặc CLI không nằm trong system path.