Model Context Protocol (MCP) Setup for AI Agent Data and Tool Connectivity

Model Context Protocol (MCP) Setup

Model Context Protocol (MCP) — открытый стандарт Anthropic для подключения AI-моделей к внешним источникам данных и инструментам. MCP определяет унифицированный протокол взаимодействия между LLM-клиентами (Claude Desktop, Cursor, IDE) и серверами, предоставляющими ресурсы, инструменты и промпты. Ключевое преимущество — один MCP-сервер работает с любым клиентом, поддерживающим стандарт.

Архитектура MCP

MCP Host (клиент): Claude Desktop, Cursor, VS Code + Continue, кастомный агент.

MCP Server: предоставляет Tools (вызываемые функции), Resources (читаемые данные), Prompts (шаблоны).

Transport: stdio (локальные серверы) или HTTP+SSE (удалённые серверы).

Настройка готовых MCP-серверов

// ~/.claude/claude_desktop_config.json (Claude Desktop)
{
  "mcpServers": {
    "filesystem": {
      "command": "npx",
      "args": ["-y", "@modelcontextprotocol/server-filesystem", "/Users/user/projects"],
      "description": "Доступ к файловой системе"
    },
    "postgres": {
      "command": "npx",
      "args": ["-y", "@modelcontextprotocol/server-postgres"],
      "env": {
        "POSTGRES_URL": "postgresql://user:password@localhost:5432/mydb"
      }
    },
    "github": {
      "command": "npx",
      "args": ["-y", "@modelcontextprotocol/server-github"],
      "env": {
        "GITHUB_PERSONAL_ACCESS_TOKEN": "ghp_..."
      }
    },
    "brave-search": {
      "command": "npx",
      "args": ["-y", "@modelcontextprotocol/server-brave-search"],
      "env": {
        "BRAVE_API_KEY": "..."
      }
    },
    "slack": {
      "command": "npx",
      "args": ["-y", "@modelcontextprotocol/server-slack"],
      "env": {
        "SLACK_BOT_TOKEN": "xoxb-..."
      }
    }
  }
}

Использование MCP в Anthropic API

import anthropic

client = anthropic.Anthropic()

# Подключение MCP-сервера через API
response = client.beta.messages.create(
    model="claude-opus-4-5",
    max_tokens=4096,
    tools=[
        {
            "type": "mcp",
            "server": {
                "type": "url",
                "url": "https://mcp.company.com/server",
                "authorization_token": "Bearer mcp-token",
            },
        }
    ],
    messages=[{
        "role": "user",
        "content": "Найди в базе данных все клиенты с просроченными платежами"
    }],
    betas=["mcp-client-2025-04-04"],
)

# Фильтрация доступных инструментов
response = client.beta.messages.create(
    model="claude-opus-4-5",
    tools=[{
        "type": "mcp",
        "server": {"type": "url", "url": "https://mcp.company.com"},
        "allowed_tools": ["query_database", "get_customer"],  # Только эти инструменты
    }],
    messages=[...],
    betas=["mcp-client-2025-04-04"],
)

Популярные готовые MCP-серверы

Практический кейс: настройка для команды разработки

Задача: разработчики используют Claude Desktop + Cursor, нужен доступ к PostgreSQL, GitHub и Jira без переключения контекста.

Конфигурация на каждой рабочей станции:

• Filesystem: папка с проектами
• PostgreSQL: development база данных (read-only user)
• GitHub: персональный токен с доступом к organization
• Jira: API-токен

Эффект: разработчики могут задавать вопросы типа «Какие PR ждут ревью более 2 дней?» или «Покажи структуру таблицы orders» прямо в Claude/Cursor без дополнительных переключений.

Сроки

• Настройка готовых MCP-серверов: 1–2 часа
• Конфигурация для команды (centralised): 1 день
• Разработка кастомного MCP-сервера: 2–5 дней (см. следующий сервис)