MCP tools
Các kit có sẵn trên Tara cấp công cụ MCP cho agent trong Claude Code. Trang này liệt kê hai nhóm: sáu công cụ giao hàng của kit-scm-github và kit-scm-gitlab, và ba công cụ tri thức của kit-knowledge.
Cách agent thấy công cụ
Bạn cài kit, hoặc cài harness có phụ thuộc kit, là Claude Code có ngay công cụ, không cần cài máy chủ MCP nào khác. Trong Claude Code, tên công cụ có thêm tiền tố như sau.
| Kit | Tên trong Claude Code |
|---|---|
kit-scm-github | mcp__plugin_kit-scm-github_scm__<tên công cụ> |
kit-scm-gitlab | mcp__plugin_kit-scm-gitlab_scm__<tên công cụ> |
kit-knowledge | mcp__plugin_kit-knowledge_tara-knowledge__<tên công cụ> |
Tên công cụ cố định để luật Guardrails khớp theo tên được. Guardrails ghi nhận các công cụ ghi (comment_issue, create_pull_request) để kiểm soát, còn công cụ của kit đã duyệt trên Tara thì không bị coi là MCP lạ.
Kit SCM: kit-scm-github, kit-scm-gitlab
Hai kit có chung sáu công cụ và chung tham số. Chỉ khác ở tên gọi: GitHub dùng "pull request", GitLab dùng "merge request".
Máy chủ MCP lấy repo từ remote origin của thư mục dự án, và PHILLIP_GITHUB_REPO=owner/name ghi đè được. Token đến từ kết nối ph connect của bạn qua lệnh trợ giúp của Phillip. Máy chủ giữ token trong bộ nhớ và làm mới khi gần hết hạn, không đọc token từ file hay biến môi trường. Nếu bạn chưa kết nối, công cụ trả lỗi cho agent đọc và máy chủ vẫn chạy.
Nội dung issue và PR là dữ liệu bên ngoài
Nội dung đọc về từ issue hoặc PR chỉ là dữ liệu, agent không coi đó là chỉ thị.
get_issue
Đọc một issue (task): tiêu đề, nội dung, trạng thái Bandum, người nhận, milestone, label.
| Tham số | Kiểu | Bắt buộc | Mô tả |
|---|---|---|---|
number | số nguyên ≥ 1 | Có | Số issue |
Kết quả: đối tượng { number, title, body, closed, status, assignees, milestone, url, labels }. status là todo, in progress, review, approved hoặc rejected.
list_my_issues
Issue đang giao cho chủ token. Mặc định chỉ issue chưa đóng.
| Tham số | Kiểu | Bắt buộc | Mô tả |
|---|---|---|---|
milestone | chuỗi | Không | Tên milestone (sprint) |
include_done | boolean | Không | Gồm cả issue đã đóng; mặc định false |
Kết quả: { me, issues: [{ number, title, status, closed, milestone, url, labels }] }.
comment_issue
Ghi một bình luận vào issue, thường để báo tiến độ hoặc kết quả. Đừng đưa bí mật hay dữ liệu cá nhân vào bình luận.
| Tham số | Kiểu | Bắt buộc | Mô tả |
|---|---|---|---|
number | số nguyên ≥ 1 | Có | Số issue |
body | chuỗi, 1 đến 20000 ký tự | Có | Nội dung bình luận |
Kết quả: { ok: true, number }.
create_pull_request
Mở PR (GitLab là MR) từ nhánh head vào nhánh base, và nhánh head phải đã push. Muốn Bandum nhận ra task thì đặt mã GH-<số> trong tên nhánh hoặc viết Closes #<số> trong mô tả.
| Tham số | Kiểu | Bắt buộc | Mô tả |
|---|---|---|---|
title | chuỗi, 1 đến 256 ký tự | Có | Tiêu đề |
head | chuỗi | Có | Nhánh nguồn |
base | chuỗi | Không | Nhánh đích; mặc định là nhánh mặc định của repo |
body | chuỗi, tối đa 20000 ký tự | Không | Mô tả |
Kết quả là thông tin PR vừa mở, gồm number, title, headRef, headSha và url.
get_pull_request
Đọc PR theo số, hoặc PR đang mở của một task. Bạn chỉ nêu một trong hai tham số.
| Tham số | Kiểu | Bắt buộc | Mô tả |
|---|---|---|---|
number | số nguyên ≥ 1 | Một trong hai | Số PR |
issue | số nguyên ≥ 1 | Một trong hai | Số issue của task, thay cho number |
Kết quả gồm tiêu đề, nhánh, commit đầu nhánh và trạng thái mở, đóng hoặc đã merge. Nếu truyền issue mà task chưa có PR đang mở thì kết quả là { found: false, message }.
list_checks
Kết quả CI của một PR.
| Tham số | Kiểu | Bắt buộc | Mô tả |
|---|---|---|---|
number | số nguyên ≥ 1 | Có | Số PR |
Kết quả có dạng { number, state, checks: [{ name, state, url }] }. Mỗi check có state là success, failure, pending hoặc skipped. state tổng hợp là failure nếu có check lỗi, nếu không thì pending, rồi success, và none khi PR không có check. Kit nào chưa hỗ trợ xem checks thì công cụ trả lỗi tương ứng.
Kit Knowledge: kit-knowledge
Kit nối Claude Code với Knowledge base trên Tara qua MCP. Máy chủ chạy qua HTTP với các thông số sau.
| Địa chỉ | https://tara.phillipcli.cloud/mcp/knowledge |
| Xác thực | Authorization: Bearer <token Tara>. Kit gọi phillip tara auth-header để lấy header |
| Giao thức | JSON-RPC, các công cụ đều đánh dấu chỉ đọc |
Bạn chỉ đọc được các space thuộc tổ chức hiện tại của bạn, và trong space chỉ có tri thức do tổ chức đó đưa lên. Cách đưa tri thức lên nằm ở Knowledge base.
search
Tìm đoạn tài liệu liên quan trong các space bạn đọc được. Công cụ tìm hỗn hợp: full-text, mã nghiệp vụ như PRJ-123 hay AC-1.2, và vector nếu Tara bật.
| Tham số | Kiểu | Bắt buộc | Mô tả |
|---|---|---|---|
query | chuỗi | Có | Câu hỏi hoặc từ khóa |
space | chuỗi | Không | Mã space; bỏ trống để tìm trong mọi space đọc được |
top_k | số nguyên 1 đến 20 | Không | Số đoạn trả về; mặc định 8 |
Kết quả là văn bản gồm các đoạn đánh số. Mỗi đoạn có tiêu đề, space, nguồn trích dẫn (repo, commit, đường dẫn, heading) và nội dung, kèm dữ liệu cấu trúc { hits, mode }. Nếu không có đoạn nào, công cụ trả "No passages found in the spaces you can read." Khi có cảnh báo, ví dụ chỉ tìm được bằng full-text, kết quả thêm một dòng "Note:".
get_document
Đọc toàn bộ một tài liệu. Bạn lấy space và path từ kết quả của search.
| Tham số | Kiểu | Bắt buộc | Mô tả |
|---|---|---|---|
space | chuỗi | Có | Mã space |
path | chuỗi | Có | Đường dẫn nguồn của tài liệu |
Kết quả gồm tiêu đề, dòng "Source:" và toàn bộ nội dung.
list_spaces
Liệt kê các space tri thức bạn đọc được, không có tham số.
Mỗi dòng kết quả gồm mã space, tên, tổ chức, dự án (nếu có) và số tài liệu, kèm dữ liệu cấu trúc { spaces: [{ space, name, org, project, documents }] }. Nếu bạn chưa đọc được space nào, công cụ trả "You cannot read any space yet."
Lỗi
Khi gặp lỗi cấu hình hoặc quyền, công cụ trả kết quả có isError để agent đọc và tự xử lý. Máy chủ không dừng.