Kết nối Claude Code (MCP)

Ian On cũng có thể được truy cập từ các công cụ AI khác. Nếu bạn dùng Claude Code hoặc một ứng dụng khác hỗ trợ MCP (tiêu chuẩn chung để kết nối công cụ AI với dữ liệu), bạn có thể cho công cụ đó trực tiếp tìm kiếm và đặt câu hỏi với bộ não vận hành — không cần xuất tệp thủ công. Công cụ được kết nối chỉ truy cập được đúng những gì tài khoản của bạn được phép xem, không hơn.

Bạn không cần là Admin (quản trị viên). Bất kỳ người dùng nào đã đăng nhập đều có thể tạo khóa cho riêng mình.

Công cụ bên ngoài có thể làm gì

Sau khi kết nối, công cụ nhận được bốn khả năng, tất cả đều giới hạn trong phạm vi tài khoản của bạn được phép.

• Tìm kiếm (ian_search) trong tri thức của công ty.
• Hỏi (ian_ask) để nhận câu trả lời có căn cứ kèm nguồn. Nếu đó là yêu cầu cần xử lý như một công việc, thay vì trả lời, nó sẽ báo bạn tạo công việc bằng ian_work_create.
• Tra cứu quyết định (ian_decision_query) — chọn một công việc và xem trong sổ cái quyết định của công việc đó ai đã quyết định gì, tại sao và khi nào.
• Bắt đầu công việc (ian_work_create) từ một mục tiêu — tạo một công việc cá nhân của bạn, bắt đầu lập kế hoạch và trả về liên kết đến công việc đó.

Để tra cứu quyết định, bạn bắt buộc phải chỉ định id (UUID) của công việc cần tra cứu trong workspaceId. Id là phần <id> trong địa chỉ màn hình công việc /work/<id>. Bất kể vai trò, mỗi lần chỉ tra cứu được một công việc; công việc nhóm chỉ tra cứu được khi bạn hiện đang thuộc nhóm đó, còn công việc cá nhân thì chỉ người tạo mới tra cứu được.

Yêu cầu ian_work_create có thể kèm (không bắt buộc) giá trị ian-on/logical-action-id trong _meta của yêu cầu. Giá trị dài từ 1 đến 200 ký tự, gồm chữ cái tiếng Anh, chữ số và các ký tự . _ : -; giá trị sai định dạng sẽ trả về lỗi. Khi thử lại cùng một yêu cầu, nếu gửi cùng giá trị thì bạn sẽ nhận lại đúng công việc đó; nếu không gửi giá trị, mỗi lần gọi sẽ tạo một công việc mới.

Thiết lập

1. Mở Settings → MCP API keys (Cài đặt → Khóa MCP API).
2. Nếu muốn, nhập tên khóa (ví dụ: Claude Code) rồi nhấn Create (Tạo).
3. Khóa chỉ hiển thị một lần — hãy sao chép ngay bằng Copy (Sao chép) và cất giữ an toàn. Bạn sẽ không thể xem lại.
4. Trang cũng hiển thị sẵn cấu hình để dán. Hãy đưa nó vào tệp .mcp.json của công cụ.

{
  "mcpServers": {
    "ian-on": {
      "type": "http",
      "url": "https://<your-ian-on>/api/mcp",
      "headers": { "Authorization": "Bearer <your-key>" }
    }
  }
}

Khởi động lại client và kiểm tra xem bốn công cụ đã hiển thị chưa. Vì Ian On chỉ cung cấp công cụ, danh sách tài nguyên (resources) và prompt để trống là bình thường. Xem đầu vào của từng công cụ và cách xử lý lỗi trong Settings → MCP API keys → Connection guide (Hướng dẫn kết nối) của ứng dụng.

Để thu hồi quyền truy cập, trong cùng mục đó hãy nhấn Revoke (Thu hồi) bên cạnh khóa, rồi xác nhận thêm một lần nữa trong hộp thoại xác nhận. Việc thu hồi không thể hoàn tác, và công cụ bên ngoài đang dùng khóa đó sẽ mất quyền truy cập ngay lập tức.