Lähe põhisisu juurde
Eesti— Vali keel
Menüü

MCP ja konektorid: universaalne standard

Õppetund 16 / 20 Arendajatele
Sellel lehel
  1. MCP ja konektorid: universaalne standard
  2. Probleem, mida MCP lahendab
  3. MCP arhitektuur
  4. OpenAI konektorite kasutamine
  5. MCP serveri loomine Pythonis
  6. MCP ressursside avaldamine
  7. MCP serveri ühendamine vastuste API-ga
  8. Muster: mitme konektori keskus
  9. Turvalisus ja autentimine
  10. Peamised punktid

MCP ja konektorid: universaalne standard

Mudeli konteksti protokoll (MCP) on avatud standard, mis võimaldab mudelitel suhelda välisteenustega ühtse protokolli kaudu. OpenAI konektorid rakendavad seda standardit, et siduda mudelid otse kolmandate osapoolte tööriistadega vastuste API-s (Responses API).

Probleem, mida MCP lahendab

Põhiprobleem seisneb integratsioonide paljunemises: N mudeli ühendamine M teenusega nõuab N×M kohandatud integratsiooni, millest igaüks kirjutatakse ja hoitakse eraldi. Iga uus teenus sunnib sind kordama sama tööd iga rakenduse jaoks ja iga API muudatus ohustab mitme integratsiooni toimimist.

MCP muudab selle korrutise summaks: teenus avaldab oma võimalused protokolli kasutades vaid üks kord ja iga ühilduv klient saab neid tarbida. See on sama loogika, mis printeridraiverite või koodiredaktorite keeleserveri protokolli (LSP) taga – standardiseerimine ei tee integratsioone võimsamaks, vaid muudab need majanduslikult jätkusuutlikuks.

# Enne MCP-d: käsitsi integratsioon iga teenuse jaoks
tools = [
    # Funktsioon Slacki jaoks
    {"type": "function", "name": "slack_send_message", ...},
    {"type": "function", "name": "slack_read_channel", ...},
    # Funktsioon Jira jaoks
    {"type": "function", "name": "jira_create_ticket", ...},
    {"type": "function", "name": "jira_list_tickets", ...},
    # Funktsioon Google Drive'i jaoks
    {"type": "function", "name": "gdrive_list_files", ...},
    # ... kümneid funktsioone, mida hooldada
]

MCP korral avaldab iga teenus oma võimalused standardse protokolli kaudu ja mudel tarbib neid otse.

MCP arhitektuur

Protokoll määratleb kolm mõistet:

  • MCP server: teenus, mis avaldab tööriistu, ressursse ja vihjeid (prompts)
  • MCP klient: süsteem, mis tarbib serveri võimalusi
  • Transport: sideserver kliendi ja serveri vahel
# MCP server avaldab:
# - Tööriistad: tegevused, mida mudel saab执行ida
# - Ressursid: andmed, mida mudel saab lugeda
# - Vihjed: eelmääratud vihjemallid

OpenAI konektorite kasutamine

Konektorid on MCP serverid, mida juba majutatakse ja hooldatakse: sa deklareerid need, autentid ja tarbid. See on loomulik sisenemispunkt – sul pole vaja kirjutada MCP serverit, et suhelda levinud teenusega, millega keegi on juba ühenduse loonud.

from openai import OpenAI

client = OpenAI()

# Kontseptuaalne näide: konektor välisele teenusele
response = client.responses.create(
    model="gpt-5.6-terra",
    input="Loo Jira pilet kodulehe vea jaoks",
    tools=[
        {
            "type": "mcp",
            "server_label": "jira",
            "server_url": "https://mcp.your-server.com/jira",
            "require_approval": "always"
        }
    ]
)

Parameeter require_approval kontrollib inimlikku kinnitust:

  • "always": Iga tegevus nõuab kinnitust
  • "never": Automaatne执行imine

MCP serveri loomine Pythonis

Oma serveri kirjutamine muutub mõttekaks niipea, kui sisemist teenust peavad kasutama mitu rakendust. Loogika on sama mis sisemise API puhul: kirjutad selle üks kord, korralikult, koos oma juurdepääsureeglitega – ja iga rakendus saab kasu ilma integratsioonikihti uuesti leiutamata.

from mcp.server import Server
from mcp.types import Tool, TextContent
import json

server = Server("my-crm")

@server.tool()
async def search_client(term: str, field: str = "name") -> str:
    """Otsi klienti sisemisest CRM-ist.

    Args:
        term: Otsingutermin (nimi, e-post või ID)
        field: Väli, millest otsida (name, email, id)
    """
    # Sinu äriloogika
    results = await crm_database.search(term, field=field)
    return json.dumps([{
        "id": r.id,
        "name": r.name,
        "email": r.email,
        "company": r.company
    } for r in results])

@server.tool()
async def create_opportunity(
    client_id: str,
    title: str,
    amount: float,
    probability: int
) -> str:
    """Loo müügivõimalus CRM-is.

    Args:
        client_id: Kliendi identifikaator
        title: Võimaluse pealkiri
        amount: Hinnanguline summa eurodes
        probability: Sulgemise tõenäosus (0-100)
    """
    opp = await crm_database.create_opportunity(
        client_id=client_id,
        title=title,
        amount=amount,
        probability=probability
    )
    return json.dumps({"id": opp.id, "status": "created"})

MCP ressursside avaldamine

MCP teeb vahet tööriistadel, mis midagi teevad, ja ressurssidel, mis pakuvad midagi lugemiseks. See eristus on oluline, sest see määratleb riski: ressurssi konsulteeritakse ilma kõrvalmõjudeta, samas kui tööriist võib muuta maailma olekut. Kinnituskontrollid keskenduvad loomupäraselt viimasele.

@server.resource("crm://pipeline")
async def sales_pipeline() -> str:
    """Müügitorustiku praegune seis."""
    pipeline = await crm_database.get_pipeline()
    return json.dumps({
        "total_opportunities": pipeline.count,
        "total_value": pipeline.total_value,
        "by_stage": {
            "prospecting": pipeline.prospecting,
            "qualification": pipeline.qualification,
            "proposal": pipeline.proposal,
            "negotiation": pipeline.negotiation,
            "closing": pipeline.closing
        }
    })

@server.resource("crm://client/{client_id}")
async def client_profile(client_id: str) -> str:
    """Kliendi täielik profiil."""
    client = await crm_database.get_client(client_id)
    return json.dumps({
        "name": client.name,
        "email": client.email,
        "purchase_history": client.purchases,
        "satisfaction_score": client.nps
    })

MCP serveri ühendamine vastuste API-ga

# MCP konektori konfiguratsioon API väljakutses
response = client.responses.create(
    model="gpt-5.6-terra",
    input="Milline on meie müügitorustiku seis? "
          "Loo võimalus kliendile CLI-789: "
          "pilveränne, 50000 eurot, 70% tõenäosus.",
    tools=[
        {
            "type": "mcp",
            "server_label": "internal-crm",
            "server_url": "https://mcp.internal.example.com/crm",
            "require_approval": "never"
        }
    ]
)

Muster: mitme konektori keskus

Siin näitab standard oma tõelist väärtust: kõrvuti deklareeritud mitu serverit, kus mudel komponeerib nende vahel – loeb siit piletit, otsib sealt klienti, kirjutab mujal vastust. Ilma ühise protokollita nõuaks sama voog kolme spetsiifilist integratsiooni ja nende pidevat hooldust.

response = client.responses.create(
    model="gpt-5.6-terra",
    input="Kontrolli avatud Jira pileteid, saada kokkuvõte Slacki "
          "ja uuenda Notioni armatuurlauda",
    tools=[
        {
            "type": "mcp",
            "server_label": "jira",
            "server_url": "https://mcp.example.com/jira",
            "require_approval": "always"
        },
        {
            "type": "mcp",
            "server_label": "slack",
            "server_url": "https://mcp.example.com/slack",
            "require_approval": "always"
        },
        {
            "type": "mcp",
            "server_label": "notion",
            "server_url": "https://mcp.example.com/notion",
            "require_approval": "always"
        }
    ]
)

Turvalisus ja autentimine

# MCP serverid haldavad autentimist päiste kaudu
# või tokenite kaudu konfiguratsiooni URL-is

# Parim tava: kasuta alati require_approval kirjutamistegevuste jaoks
tools = [
    {
        "type": "mcp",
        "server_label": "crm",
        "server_url": "https://mcp.example.com/crm",
        "require_approval": "always",  # Inimlik kinnitamine
        "allowed_tools": ["search_client", "client_profile"],  # Piira tööriistu
    }
]

Peamised punktid

  • MCP on avatud standard mudelite ühendamiseks välisteenustega
  • OpenAI konektorid integreerivad MCP otse vastuste API-sse
  • Ehita oma MCP servereid sisemiste teenuste avaldamiseks
  • Kasuta require_approval inimliku kinnituse kontrollimiseks
  • Ühenda mitu MCP serverit ühes väljakutses ristfunktsionaalsete töövoogude jaoks