Claude Kỹ thuật: Hướng dẫn Kết nối Công cụ

Kỹ sư phần mềm làm việc với nhiều hệ thống cùng lúc — code trên GitHub, task trên Linear, alert từ Datadog, incident trên PagerDuty, tài liệu trên Notion, và trao đổi trên Slack. Claude kết nối với toàn bộ hệ sinh thái kỹ thuật này thông qua MCP (Model Context Protocol), cho phép kỹ sư debug, review, và phối hợp xử lý sự cố ngay trong cuộc hội thoại với đầy đủ ngữ cảnh từ các hệ thống thực tế.

Bài viết này trình bày kiến trúc kết nối, bảy danh mục connector được hỗ trợ trong plugin kỹ thuật, và hướng dẫn thiết lập từng bước.

Kiến trúc kết nối

Plugin kỹ thuật hoạt động theo mô hình tool-agnostic — quy trình làm việc được định nghĩa theo danh mục chức năng, không phụ thuộc vào GitHub hay GitLab cụ thể. Các placeholder trong file plugin có dạng ~~category:

• ~~source control — đại diện cho hệ thống quản lý phiên bản code
• ~~CI/CD — đại diện cho hệ thống tích hợp và triển khai liên tục
• ~~monitoring — đại diện cho công cụ giám sát hệ thống và ứng dụng
• ~~incident management — đại diện cho nền tảng quản lý sự cố
• ~~project tracker — đại diện cho công cụ quản lý backlog và sprint
• ~~knowledge base — đại diện cho tài liệu kỹ thuật và runbook
• ~~chat — đại diện cho kênh trao đổi nội bộ nhóm kỹ thuật

Thiết kế tool-agnostic đặc biệt quan trọng trong môi trường kỹ thuật — stack công cụ thay đổi theo quy mô tổ chức, ưu tiên kỹ thuật, và ngân sách. Khi đội chuyển từ GitHub sang GitLab, hoặc từ PagerDuty sang Opsgenie, chỉ cần cập nhật .mcp.json.

Danh sách kết nối hỗ trợ

Plugin kỹ thuật hỗ trợ bảy danh mục connector, bao phủ toàn bộ vòng đời phát triển phần mềm:

Lưu ý: Danh mục ~~CI/CD hiện chưa có MCP server mặc định. Bạn cần tự cấu hình một trong các lựa chọn thay thế. GitHub Actions có thể được truy cập một phần qua GitHub MCP server (source control connector).

Cách thiết lập kết nối

Quy trình thiết lập cho đội kỹ thuật thường bắt đầu với hai connector cốt lõi: source control và monitoring. Đây là hai nguồn thông tin Claude cần nhất khi hỗ trợ debug và review code.

Bước 1: Thiết lập GitHub MCP

GitHub cung cấp MCP server chính thức được Anthropic đề xuất. Tạo Personal Access Token (PAT) với các quyền phù hợp:

• repo — đọc và ghi repository
• issues — quản lý issue và PR
• actions — đọc workflow runs (nếu cần CI/CD)

Không cấp quyền ghi nếu bạn chỉ muốn Claude đọc code và phân tích.

Bước 2: Kết nối monitoring

Datadog MCP server cho phép Claude truy cập metric, log, và trace trực tiếp. Khi debug một vấn đề production, Claude có thể đọc log thực tế thay vì chỉ phân tích code. Tạo API key và Application key từ Datadog console.

Bước 3: Kết nối incident management

PagerDuty connector đặc biệt có giá trị trong quy trình on-call. Claude có thể đọc chi tiết incident, lịch sử timeline, và runbook liên quan để hỗ trợ xử lý sự cố nhanh hơn.

Bước 4: Kết nối knowledge base và project tracker

Notion hoặc Confluence chứa runbook, kiến trúc hệ thống, và quyết định kỹ thuật. Kết nối với project tracker để Claude có thể tạo bug report với đầy đủ ngữ cảnh kỹ thuật.

Ví dụ cấu hình .mcp.json

Cấu hình mẫu cho stack kỹ thuật phổ biến: GitHub, Datadog, PagerDuty, Jira, và Slack:

{
  "mcpServers": {
    "github": {
      "command": "npx",
      "args": ["-y", "@modelcontextprotocol/server-github"],
      "env": {
        "GITHUB_PERSONAL_ACCESS_TOKEN": "ghp_your_token"
      }
    },
    "datadog": {
      "command": "npx",
      "args": ["-y", "@modelcontextprotocol/server-datadog"],
      "env": {
        "DATADOG_API_KEY": "your_api_key",
        "DATADOG_APP_KEY": "your_app_key",
        "DATADOG_SITE": "datadoghq.com"
      }
    },
    "pagerduty": {
      "command": "npx",
      "args": ["-y", "@modelcontextprotocol/server-pagerduty"],
      "env": {
        "PAGERDUTY_API_TOKEN": "your_api_token"
      }
    },
    "jira": {
      "command": "npx",
      "args": ["-y", "@modelcontextprotocol/server-atlassian"],
      "env": {
        "ATLASSIAN_HOST": "https://your-org.atlassian.net",
        "ATLASSIAN_EMAIL": "your@email.com",
        "ATLASSIAN_TOKEN": "your_api_token"
      }
    },
    "slack": {
      "command": "npx",
      "args": ["-y", "@modelcontextprotocol/server-slack"],
      "env": {
        "SLACK_BOT_TOKEN": "xoxb-your-token",
        "SLACK_TEAM_ID": "T0XXXXXXX"
      }
    },
    "notion": {
      "command": "npx",
      "args": ["-y", "@modelcontextprotocol/server-notion"],
      "env": {
        "NOTION_API_TOKEN": "your_notion_token"
      }
    }
  }
}

Để thêm CI/CD qua CircleCI:

"circleci": {
  "command": "npx",
  "args": ["-y", "@modelcontextprotocol/server-circleci"],
  "env": {
    "CIRCLECI_TOKEN": "your_circleci_token"
  }
}

Tùy chỉnh và mở rộng

Môi trường kỹ thuật thường có yêu cầu tùy chỉnh phức tạp hơn so với các domain khác:

GitLab thay GitHub: Đội dùng self-hosted GitLab? Đổi entry github sang gitlab với URL instance nội bộ. Plugin tiếp tục hoạt động vì nó tham chiếu ~~source control.

Grafana thay Datadog: Nếu tổ chức dùng stack monitoring mã nguồn mở (Prometheus + Grafana), thay connector datadog bằng grafana. Cần cấu hình Grafana MCP server với URL instance và API key.

Opsgenie hoặc Incident.io: Các lựa chọn thay thế PagerDuty đều có MCP server riêng. Đổi entry trong .mcp.json và cập nhật credentials phù hợp.

Nhiều repository GitHub: MCP server GitHub tự động có quyền truy cập tất cả repository mà token được cấp phép. Bạn không cần khai báo riêng từng repo — chỉ cần một entry duy nhất với token có đủ quyền.

Jenkins self-hosted: Nếu đội chạy Jenkins nội bộ, cần deploy Jenkins MCP adapter trên server và cung cấp URL endpoint trong cấu hình. Đây là trường hợp cần setup phức tạp hơn nhưng mang lại quyền truy cập đầy đủ vào build pipeline.

Kịch bản sử dụng thực tế

Khi đầy đủ connector, Claude có thể hỗ trợ các tình huống kỹ thuật phức tạp trong thực tế:

• Phân tích PR trên GitHub kết hợp với context từ Jira ticket và Notion architecture docs
• Debug production issue bằng cách đọc Datadog log và trace trực tiếp, không cần copy-paste
• Xử lý incident: đọc PagerDuty alert, tra cứu runbook Notion, và cập nhật Slack channel cùng lúc
• Tạo bug report chi tiết trên Jira với stack trace từ Datadog và code reference từ GitHub
• Soạn thảo post-mortem với timeline đầy đủ dựa trên dữ liệu từ PagerDuty và Datadog

Bảo mật cho môi trường kỹ thuật

Connector kỹ thuật thường có quyền truy cập vào hệ thống nhạy cảm nhất của tổ chức. Một số nguyên tắc cần tuân thủ:

• Dùng token read-only cho connector monitoring — Claude không cần quyền tắt alert hay thay đổi cấu hình
• Với GitHub, cân nhắc tạo machine user riêng thay vì dùng PAT cá nhân, đặc biệt cho môi trường nhóm
• Lưu tất cả credentials trong secret manager (AWS Secrets Manager, Vault, hoặc biến môi trường hệ thống), không hardcode trong .mcp.json
• Định kỳ audit quyền của các token MCP, đặc biệt sau khi nhân sự thay đổi

Bước tiếp theo

Với hệ sinh thái công cụ kỹ thuật được kết nối đầy đủ, Claude trở thành đồng đội kỹ thuật thực sự — không chỉ giải thích khái niệm mà còn đọc được code thực, log thực, và incident thực của hệ thống bạn đang vận hành. Khám phá thêm các plugin và ứng dụng tại Thư viện Ứng dụng.

Bài viết liên quan

• Claude cho Engineering: System Design interviews và planning
• Claude cho Engineering: Thiết kế kiến trúc hệ thống
• Claude Phân tích Dữ liệu: Hướng dẫn Kết nối Công cụ
• Claude Bán hàng: Hướng dẫn Kết nối Công cụ
• Claude Hỗ trợ Khách hàng: Hướng dẫn Kết nối Công cụ