Интеграции MCP API

Введение в Model Context Protocol (MCP)

James Chapman

AI Curriculum Manager, DataCamp

mcp_code_flow_v2.png

Введение в Model Context Protocol (MCP)

Улучшения API

Введение в Model Context Protocol (MCP)

Улучшения API

apis_improvs2.png

Введение в Model Context Protocol (MCP)

Улучшения API

apis_improvs3.png

Введение в Model Context Protocol (MCP)

Таймаут и обработка ошибок

import requests

@mcp.tool()
def convert_timezone(date_time: str, from_timezone: str, to_timezone: str) -> str:
    payload = {"dateTime": date_time, "fromTimezone": from_timezone, "toTimezone": to_timezone}


    try:
        r = requests.post("https://api.opentimezone.com/convert", json=payload, timeout=10)

        r.raise_for_status()

        data = r.json()
        converted_time = data.get("dateTime", "N/A")
        return f"Time in {to_timezone}: {converted_time}"

    except requests.exceptions.RequestException as e:
        return f"Error converting timezone: {e}"
Введение в Model Context Protocol (MCP)

Аутентификация API: правила и запреты

 

  • API-ключи → всегда используются на стороне сервера

 

local_api1.png

Введение в Model Context Protocol (MCP)

Аутентификация API: правила и запреты

 

  • API-ключи → всегда используются на стороне сервера
    • Локальный хост: переменные среды, .env

 

local_api2.png

Введение в Model Context Protocol (MCP)

Аутентификация API: правила и запреты

 

  • API-ключи → всегда используются на стороне сервера
    • Локальный хост: переменные среды, .env
    • Удалённый хост: переменные среды, управляемые секреты

 

remote_api1.png

Введение в Model Context Protocol (MCP)

Аутентификация API: правила и запреты

 

  • API-ключи → всегда используются на стороне сервера
    • Локальный хост: переменные среды, .env
    • Удалённый хост: переменные среды, управляемые секреты

Клиент никогда не отправляет, не получает и не использует учётные данные

 

remote_api2.png

Введение в Model Context Protocol (MCP)

Аутентификация API: правила и запреты

 

  • API-ключи → всегда используются на стороне сервера
    • Локальный хост: переменные среды, .env
    • Удалённый хост: переменные среды, управляемые секреты

Клиент никогда не отправляет, не получает и не использует учётные данные

❌ Жёстко закодированы, вставлены в URL, занесены в журнал

❌ Аргументы или результаты инструментов

 

remote_api3.png

Введение в Model Context Protocol (MCP)
import os
import requests

@mcp.tool()
def convert_timezone(date_time: str, from_timezone: str, to_timezone: str) -> str:

    headers = {"Content-Type": "application/json"}

    api_key = os.environ.get("TIMEZONE_API_KEY")
    if api_key:
        headers["Authorization"] = f"Bearer {api_key}"

    payload = {"dateTime": date_time, "fromTimezone": from_timezone, "toTimezone": to_timezone}
    try:
        r = requests.post("https://api.opentimezone.com/convert", json=payload, headers=headers, timeout=10)
        r.raise_for_status()
        data = r.json()
        converted_time = data.get("dateTime", "N/A")
        return f"Time in {to_timezone}: {converted_time}"
    except requests.exceptions.RequestException as e:
        return f"Error converting timezone: {e}"
Введение в Model Context Protocol (MCP)

Попрактикуемся!

Введение в Model Context Protocol (MCP)

Preparing Video For Download...