PHẦN XV — CLAUDE PLUGINS & EXTENSIONS

---

15.1 Plugin vs Extension vs Connector — Phân biệt

💡 Nhớ nhanh: Connectors = đọc dữ liệu. Extensions = thêm công cụ. Plugins = gói quy trình.

---

15.2 Desktop Extensions — Mở rộng Claude Desktop

Extension là gì?

Extension = một MCP server chạy cục bộ hoặc từ xa, cung cấp cho Claude Desktop công cụ mới mà Claude gốc không có.

Ví dụ: Extension "Database" cho phép Claude truy vấn PostgreSQL trực tiếp. Extension "Filesystem" cho phép Claude đọc/ghi file trên máy tính.

Cài đặt Extension — 3 cách

Cách 1: Official Directory (Dễ nhất)

Claude Desktop → Settings → Extensions → Browse extensions
→ Chọn extension → Install → Authorize

• ✅ An toàn (Anthropic đã verify)
• ✅ 1-click install
• ❌ Số lượng hạn chế

Cách 2: File .mcpb (Extension đóng gói)

Claude Desktop → Settings → Extensions → Advanced settings
→ Install Extension → Chọn file .mcpb → Install

• ✅ Dùng cho extensions từ nguồn tin cậy
• ⚠️ Kiểm tra nguồn trước khi cài

Cách 3: Cấu hình thủ công (Cho CAS/Dev)

Sửa file cấu hình:

• Windows: %APPDATA%\Claude\claude_desktop_config.json
• macOS: ~/Library/Application Support/Claude/claude_desktop_config.json

{
  "mcpServers": {
    "vagataba-odoo": {
      "command": "python",
      "args": ["-m", "vagataba_mcp_server"],
      "env": {
        "ODOO_URL": "https://odoo.vagataba.com",
        "ODOO_DB": "vagataba_prod"
      }
    }
  }
}

⚠️ Cách 3 chỉ dành cho CAS. NV thường dùng Cách 1 hoặc 2.

---

15.3 Cowork Plugins — Workflow đóng gói

Plugin là gì?

Plugin = gói kết hợp Skills + MCP servers + Agent configuration thành 1 package, cài 1-click trong Cowork.

So sánh Skill vs Plugin:

Cài đặt Plugin

Claude Desktop → Cowork tab → Customize → Plugins
→ Browse marketplace → Chọn plugin → Install

Hoặc dùng Organization Marketplace:

Organization Settings → Plugin Marketplace → Upload plugin
→ NV trong tổ chức tự cài từ marketplace nội bộ

---

15.4 Ứng dụng tại Vagataba

A. Extensions thực tế

B. Plugins nên phát triển

---

15.5 Xây dựng Plugin cho Vagataba (CAS Guide)

Cấu trúc Plugin

vagataba-tpcn-compliance/
├── plugin.json           # Metadata: tên, version, dependencies
├── skills/
│   ├── SKILL.md          # Logic check TPCN
│   └── examples/         # Ví dụ output
├── mcp/
│   └── tpcn_checker.py   # MCP server: check từ cấm tự động
├── agents/
│   └── AGENT.md          # Agent config: multi-step workflow
└── README.md             # Hướng dẫn cài đặt

File plugin.json mẫu

{
  "name": "TPCN Compliance Suite",
  "version": "1.0.0",
  "description": "Auto-check content TPCN cho Vagataba: từ cấm, disclaimer, compliance score",
  "author": "Vagataba CAS",
  "requires": {
    "claude_desktop": ">=2.5.0",
    "mcp_protocol": ">=1.0"
  },
  "skills": ["skills/SKILL.md"],
  "mcp_servers": ["mcp/tpcn_checker.py"],
  "agents": ["agents/AGENT.md"],
  "permissions": ["filesystem:read", "web:search"]
}

MCP Server mẫu — TPCN Checker (Python)

"""
MCP Server: TPCN Compliance Checker cho Vagataba
Kiểm tra content có vi phạm từ cấm TPCN không.
"""
from mcp.server import Server
from mcp.types import Tool, TextContent

BANNED_WORDS = [
    "chữa", "trị", "khỏi", "đặc trị",
    "100% hiệu quả", "cam kết", "thay thế thuốc",
    "chữa bệnh", "trị liệu", "điều trị"
]

DISCLAIMER = "Thực phẩm này không phải là thuốc và không có tác dụng thay thế thuốc chữa bệnh."

server = Server("tpcn-checker")

@server.tool()
async def check_tpcn(content: str) -> str:
    """Kiểm tra content TPCN — tìm từ cấm và thiếu disclaimer."""
    violations = []
    for word in BANNED_WORDS:
        if word.lower() in content.lower():
            violations.append(f"❌ Từ cấm: '{word}'")

    has_disclaimer = DISCLAIMER.lower() in content.lower() or "không phải là thuốc" in content.lower()
    if not has_disclaimer:
        violations.append("❌ Thiếu disclaimer TPCN")

    if violations:
        score = max(0, 10 - len(violations) * 2)
        return f"⚠️ Phát hiện {len(violations)} vi phạm (Score: {score}/10):\n" + "\n".join(violations)
    return "✅ Content OK — không phát hiện vi phạm TPCN (Score: 10/10)"

---

15.6 An toàn Plugins & Extensions

5 quy tắc bảo mật

Rủi ro cần biết

🔴 TPCN Alert: Plugin xử lý content tự động (ví dụ auto-post) → BẮT BUỘC có bước human review trước khi publish. Không bao giờ auto-publish content TPCN.

---

15.7 Managed Extensions cho Enterprise (CAS Setup)

Allowlist Extensions cho Vagataba

CAS tạo file managed-settings.json push qua MDM:

{
  "allowed_extensions": [
    "official/filesystem",
    "official/google-workspace",
    "official/web-browser",
    "vagataba/odoo-connector",
    "vagataba/tpcn-compliance"
  ],
  "blocked_extensions": ["*"],
  "require_admin_approval": true
}

→ NV chỉ cài được extensions trong allowlist. Extensions ngoài danh sách → bị chặn.

Organization Plugin Marketplace

Claude Desktop → Organization Settings → Plugin Marketplace
→ Upload plugin (.zip hoặc .mcpb)
→ Set visibility: "Organization only" hoặc "Team only"
→ NV cài từ marketplace nội bộ

---

15.8 Lộ trình phát triển — 3 giai đoạn

---

15.9 Tham chiếu đào tạo quốc tế

📖 Lộ trình CAS nâng cao: Claude Code 101 → Introduction to MCP → MCP Advanced → Building with Claude API → Claude Certified Architect

---

15.10 Bảng tổng hợp Customize — 4 thành phần

💡 Mối quan hệ: Skills = "Claude biết làm gì". Connectors = "Claude đọc được gì". Plugins = "Claude làm được gì thêm (với tools)".

---

Tài liệu nội bộ Vagataba — V6.0 — 05/2026 Tham chiếu: 00_Tong_Quan.md | 13_Claude_Skills.md (Skills) | 14_Claude_Connectors.md (Connectors)