MCP (Model Context Protocol)

MCP (Model Context Protocol) là protocol cho phép Antigravity kết nối với các công cụ và dịch vụ bên ngoài.

MCP là gì?

MCP là một open protocol để:

Kết nối AI agents với external tools
Cung cấp context từ nhiều nguồn
Mở rộng khả năng của Agent

Tại sao cần MCP?

Thay vì Agent phải tự implement mọi integration, MCP cho phép:

Tái sử dụng các connectors có sẵn
Standardized cách giao tiếp
Community-driven development

MCP Servers

MCP hoạt động qua các MCP Servers - các service cung cấp tools và resources cho Agent.

Ví dụ MCP Servers

Server	Chức năng
GitHub	Quản lý repos, PRs, issues
Notion	Đọc/viết Notion documents
Database	Query và update databases
Slack	Gửi messages, manage channels
Linear	Project management

Cấu hình MCP

Cấu trúc config


{
  "mcpServers": {
    "github": {
      "command": "npx",
      "args": ["-y", "@modelcontextprotocol/server-github"],
      "env": {
        "GITHUB_TOKEN": "your_token_here"
      }
    },
    "notion": {
      "command": "npx",
      "args": ["-y", "@modelcontextprotocol/server-notion"],
      "env": {
        "NOTION_API_KEY": "your_key_here"
      }
    }
  }
}

Nơi lưu config

Global: ~/.antigravity/mcp.json
Project: .antigravity/mcp.json

Sử dụng MCP

Liệt kê Resources

Agent có thể liệt kê resources từ MCP server:


"Liệt kê các repos trong GitHub organization của tôi"

Đọc Resources


"Đọc nội dung file README từ repo main-project"

Sử dụng Tools


"Tạo issue mới trên GitHub: 'Fix login bug'"

Popular MCP Integrations

GitHub


{
  "github": {
    "command": "npx",
    "args": ["-y", "@modelcontextprotocol/server-github"],
    "env": {
      "GITHUB_TOKEN": "ghp_xxxx"
    }
  }
}

Capabilities:

List repositories
Read files
Create/update PRs
Manage issues

Notion


{
  "notion": {
    "command": "npx",
    "args": ["-y", "@modelcontextprotocol/server-notion"],
    "env": {
      "NOTION_API_KEY": "secret_xxxx"
    }
  }
}

Capabilities:

Read pages/databases
Create content
Update existing pages

PostgreSQL


{
  "postgres": {
    "command": "npx",
    "args": ["-y", "@modelcontextprotocol/server-postgres"],
    "env": {
      "DATABASE_URL": "postgresql://..."
    }
  }
}

Capabilities:

Query database
Schema inspection
Data manipulation

Tạo Custom MCP Server

Bạn có thể tạo MCP server riêng:

1. Khởi tạo project


npm init -y
npm install @modelcontextprotocol/sdk

2. Implement server


import { Server } from '@modelcontextprotocol/sdk/server';
 
const server = new Server({
  name: 'my-custom-server',
  version: '1.0.0'
});
 
// Define tools
server.setRequestHandler('tools/list', async () => {
  return {
    tools: [
      {
        name: 'my_tool',
        description: 'Does something useful',
        inputSchema: {
          type: 'object',
          properties: {
            param: { type: 'string' }
          }
        }
      }
    ]
  };
});
 
// Handle tool calls
server.setRequestHandler('tools/call', async (request) => {
  if (request.params.name === 'my_tool') {
    // Implementation
    return { result: 'Success!' };
  }
});
 
server.start();

3. Đăng ký với Antigravity


{
  "my-custom": {
    "command": "node",
    "args": ["./my-server.js"]
  }
}

Best Practices

🔐 Bảo mật Credentials

Sử dụng environment variables
Không commit tokens vào Git
Rotate credentials định kỳ

⚡ Performance

MCP calls có latency
Cache khi có thể
Batch related operations

🧪 Testing

Test MCP connections trước khi dùng
Handle errors gracefully
Validate responses

MCP vs Direct API

Aspect	MCP	Direct API
Standardization	✅ Protocol chung	❌ Mỗi API khác nhau
Reusability	✅ Community servers	❌ Phải tự implement
Learning curve	✅ Một lần	❌ Mỗi API phải học
Flexibility	Trung bình	Cao

Troubleshooting

MCP Server không start


- Kiểm tra command và args
- Verify environment variables
- Check logs for errors

Connection timeout


- Tăng timeout trong config
- Kiểm tra network connectivity
- Verify server is running

Permission denied


- Kiểm tra API keys/tokens
- Verify scopes và permissions
- Check rate limits