Bỏ qua, đến phần nội dung

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.

KitTên trong Claude Code
kit-scm-githubmcp__plugin_kit-scm-github_scm__<tên công cụ>
kit-scm-gitlabmcp__plugin_kit-scm-gitlab_scm__<tên công cụ>
kit-knowledgemcp__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ểuBắt buộcMô tả
numbersố nguyên ≥ 1Có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ểuBắt buộcMô tả
milestonechuỗiKhôngTên milestone (sprint)
include_donebooleanKhôngGồ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ểuBắt buộcMô tả
numbersố nguyên ≥ 1CóSố issue
bodychuỗ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ểuBắt buộcMô tả
titlechuỗi, 1 đến 256 ký tựCóTiêu đề
headchuỗiCóNhánh nguồn
basechuỗiKhôngNhánh đích; mặc định là nhánh mặc định của repo
bodychuỗi, tối đa 20000 ký tựKhôngMô 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ểuBắt buộcMô tả
numbersố nguyên ≥ 1Một trong haiSố PR
issuesố nguyên ≥ 1Một trong haiSố 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ểuBắt buộcMô tả
numbersố nguyên ≥ 1Có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ựcAuthorization: Bearer <token Tara>. Kit gọi phillip tara auth-header để lấy header
Giao thứcJSON-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.

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ểuBắt buộcMô tả
querychuỗiCóCâu hỏi hoặc từ khóa
spacechuỗiKhôngMã space; bỏ trống để tìm trong mọi space đọc được
top_ksố nguyên 1 đến 20KhôngSố đ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ểuBắt buộcMô tả
spacechuỗiCóMã space
pathchuỗiCóĐườ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.

Đọc thêm ​