Skills & MCP

KOPA AI Agent dựa trên Model Context Protocol (MCP) + agent skills để tổ chức tool và knowledge.

Skills#

Một skill là một bộ tool + prompt + knowledge bundled lại để giải quyết một nhóm bài toán.

Skills mặc định của KOPA#

• Vietnamese Accounting Pack — chế độ kế toán doanh nghiệp, mẫu tờ khai, biểu thuế.
• Banking Reconciliation Pack — đối soát ngân hàng VN.
• Payroll Pack — lương + BHXH + TNCN.
• Reporting Pack — báo cáo tài chính + board-ready.
• Forecast Pack — multi-scenario modeling.

Cài skill mới#

1. Settings → Skills → Marketplace.
2. Browse skill (KOPA + 3rd party).
3. Bấm Install.
4. Cấu hình parameters nếu cần (ví dụ ngưỡng VAT, mặc định tài khoản).
5. Skill sẵn sàng dùng trong AI Agent.

Disable skill#

Tắt skill không dùng để giảm token tiêu thụ:

• AI Agent có ít context hơn → response nhanh hơn + rẻ hơn.
• Tránh AI suggest sai workflow.

Tự build skill#

Doanh nghiệp có nhu cầu đặc thù có thể tự build:

1. Skill structure: SKILL.md + tools + prompts.
2. Push lên KOPA workspace hoặc public marketplace.
3. Reference: https://docs.getkopa.com/.well-known/agent-skills/index.json.

MCP servers#

MCP = Model Context Protocol. Cho phép AI Agent kết nối tool bên ngoài.

MCP servers có sẵn#

KOPA bundled với:

• filesystem — read/write file (sandboxed).
• github — repo management.
• postgres — query database.
• calendar — Google/Outlook calendar.

Cài MCP custom#

1. Settings → Skills → MCP servers → + Add.
2. Cung cấp:
   • Name + Description.
   • Command (cho stdio MCP) hoặc URL (cho HTTP MCP).
   • Auth — bearer token / OAuth.
3. KOPA test connection.
4. Approve các tool MCP server cung cấp (KOPA hiện list, bạn tick).

Public MCP của KOPA#

KOPA xuất bản MCP read-only cho dữ liệu kế toán:

• Endpoint: https://mcp.getkopa.com/mcp
• Card: https://getkopa.com/.well-known/mcp/server-card.json
• Auth: Bearer token (lấy từ Settings → API tokens).

Dùng với Claude Desktop, ChatGPT, Cursor, hoặc agent tự build:

{
  "mcpServers": {
    "kopa": {
      "url": "https://mcp.getkopa.com/mcp",
      "auth": {
        "type": "bearer",
        "token": "kopa_pat_..."
      }
    }
  }
}

Token usage#

Theo dõi tiêu thụ token AI:

• Theo user — ai dùng nhiều.
• Theo skill — skill nào tốn token.
• Theo model — Claude/GPT/Gemini.
• Cost — quy ra VND.

Set alerts khi tiêu thụ vượt ngưỡng tháng.

Approval policy#

Cho từng tool, set approval:

• Always allow — auto-approve.
• Always require approval — luôn hỏi user.
• Conditional — approve nếu thỏa điều kiện (vd số tiền < 1tr).

Default cho tool có rủi ro (sendEmail, createPaymentBatch): luôn require approval.