Aqbeż għall-kontenut ewlieni
Malti— Agħżel lingwa
Menu

MCP u l-Konnetturi: L-Istandard Universali

Lezzjoni 16 / 20 Zviluppatur
F'din il-paġna
  1. MCP u l-Konnetturi: L-Istandard Universali
  2. Il-Problema li Solva l-MCP
  3. L-Arkitettura tal-MCP
  4. L-Użu tal-Konnetturi ta’ OpenAI
  5. Il-Ħolqien ta’ Server MCP f’Python
  6. L-Espożizzjoni tar-Riżorsi MCP
  7. Il-Konnessjoni ta’ Server MCP mal-API tar-Risposti
  8. Mudell: Ċentru Multi-Konnettur
  9. Sigurtà u Awtentikazzjoni
  10. Punti Ewlenin

MCP u l-Konnetturi: L-Istandard Universali

Il-Model Context Protocol (MCP) huwa standard miftuħ li jippermetti lill-mudelli jinteraġixxu ma’ servizzi esterni permezz ta’ protokoll unifikat. Il-Konnetturi ta’ OpenAI jimplimentaw dan l-istandard biex jorbtu l-mudelli direttament ma’ għodod ta’ partijiet terzi fi ħdan l-API tar-Risposti.

Il-Problema li Solva l-MCP

Il-kwistjoni ewlenija hija l-multiplikazzjoni tal-integrazzjonijiet: il-konnessjoni ta’ N mudell ma’ M servizz teħtieġ N×M integrazzjoni personalizzata, miktuba u miżmuma separatament. Kull servizz ġdid jfurzak tirrepeti x-xogħol għal kull applikazzjoni, u kull bidla fl-API tirriskja li tkisser integrazzjonijiet multipli.

L-MCP ibiddel dan il-prodott f’somma: is-servizz jesponi l-kapaċitajiet tiegħu darba biss bl-użu tal-protokoll, u kwalunkwe klijent kompatibbli jikkonsmahom. Din hija l-istess loġika wara s-sewwieqa tal-printers jew il-Language Server Protocol (LSP) fl-edituri tal-kodiċi—l-istandardizzazzjoni ma tagħmilx l-integrazzjonijiet aktar qawwija; tagħmilhom ekonomikament sostenibbli.

# Qabel l-MCP: integrazzjoni manwali għal kull servizz
tools = [
    # Funzjoni għal Slack
    {"type": "function", "name": "slack_send_message", ...},
    {"type": "function", "name": "slack_read_channel", ...},
    # Funzjoni għal Jira
    {"type": "function", "name": "jira_create_ticket", ...},
    {"type": "function", "name": "jira_list_tickets", ...},
    # Funzjoni għal Google Drive
    {"type": "function", "name": "gdrive_list_files", ...},
    # ... għexieren ta' funzjonijiet biex tinżammu
]

Bl-MCP, kull servizz jesponi l-kapaċitajiet tiegħu permezz ta’ protokoll standard, u l-mudell jikkonsmahom direttament.

L-Arkitettura tal-MCP

Il-protokoll jiddefinixxi tliet kunċetti:

  • Server MCP: Servizz li jesponi għodod, riżorsi u prompts
  • Klijent MCP: Is-sistema li tikkonsma l-kapaċitajiet tas-server
  • Trasport: Il-kanal ta’ komunikazzjoni bejn il-klijent u s-server
# Server MCP jesponi:
# - Għodod: Azzjonijiet li l-mudell jista' jwettaq
# - Riżorsi: Dejta li l-mudell jista' jaqra
# - Prompts: Mudelli ta' prompts predefiniti

L-Użu tal-Konnetturi ta’ OpenAI

Il-Konnetturi huma servers MCP li diġà huma ospitati u miżmuma: inti tiddikjarahom, tawtentika ruħek, u tikkonsmahom. Dan huwa l-punt tad-dħul naturali—m’hemmx bżonn tikteb server MCP biex titkellem ma’ servizz komuni li xi ħadd ieħor diġà kkollega.

from openai import OpenAI

client = OpenAI()

# Eżempju kunċettwali: konnettur ma' servizz estern
response = client.responses.create(
    model="gpt-5.6-terra",
    input="Oħloq tikketta Jira għall-bug tal-homepage",
    tools=[
        {
            "type": "mcp",
            "server_label": "jira",
            "server_url": "https://mcp.your-server.com/jira",
            "require_approval": "always"
        }
    ]
)

Il-parametru require_approval jikkontrolla l-validazzjoni umana:

  • "always": Kull azzjoni teħtieġ approvazzjoni
  • "never": Eżekuzzjoni awtomatika

Il-Ħolqien ta’ Server MCP f’Python

Il-kitba tas-server tiegħek stess issir utli hekk kif servizz intern jeħtieġ li jkun aċċessibbli minn applikazzjonijiet multipli. Il-loġika hija l-istess bħal għal API interna: tiktebha darba biss, b’mod nadif, bir-regoli ta’ aċċess tagħha stess—u kull applikazzjoni tibbenefika mingħajr ma terġa’ tinventa s-saff tal-integrazzjoni.

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:
    """Fittex klijent fis-CRM intern.

    Args:
        term: It-terminu tat-tiftix (isem, email, jew ID)
        field: Il-qasam li fih trid tfittex (isem, email, id)
    """
    # Il-loġika tan-negozju tiegħek
    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:
    """Oħloq opportunità ta' bejgħ fis-CRM.

    Args:
        client_id: Identifikatur tal-klijent
        title: Titolu tal-opportunità
        amount: Ammont stmat bl-euro
        probability: Probabbiltà li tingħalaq (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"})

L-Espożizzjoni tar-Riżorsi MCP

L-MCP jagħmel distinzjoni bejn għodod, li jagħmlu xi ħaġa, u riżorsi, li jipprovdu xi ħaġa biex taqra. Din id-distinzjoni hija importanti għax tiddefinixxi r-riskju: riżorsa tiġi kkonsultata mingħajr effetti sekondarji, filwaqt li għodda tista’ timmodifika l-istat tad-dinja. Il-kontrolli tal-approvazzjoni naturalment jiffukaw fuq tal-aħħar.

@server.resource("crm://pipeline")
async def sales_pipeline() -> str:
    """L-istat attwali tal-pipeline tal-bejgħ."""
    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:
    """Profil sħiħ ta' klijent."""
    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
    })

Il-Konnessjoni ta’ Server MCP mal-API tar-Risposti

# Konfigurazzjoni tal-konnettur MCP fis-sejħa tal-API
response = client.responses.create(
    model="gpt-5.6-terra",
    input="X'inhu l-istatus tal-pipeline tal-bejgħ tagħna? "
          "Oħloq opportunità għall-klijent CLI-789: "
          "migrazzjoni tas-sħab, 50000 euro, probabbiltà ta' 70%.",
    tools=[
        {
            "type": "mcp",
            "server_label": "internal-crm",
            "server_url": "https://mcp.internal.example.com/crm",
            "require_approval": "never"
        }
    ]
)

Mudell: Ċentru Multi-Konnettur

Hawnhekk fejn l-istandard verament jiddi: servers multipli ddikjarati ħdejn xulxin, bil-mudell jikkomponta bejniethom—jaqra tikketta hawn, ifittex klijent hemm, jikteb risposta f’post ieħor. Mingħajr protokoll komuni, l-istess fluss ikun jeħtieġ tliet integrazzjonijiet speċifiċi u l-manutenzjoni kontinwa tagħhom.

response = client.responses.create(
    model="gpt-5.6-terra",
    input="Iċċekkja t-tikketti Jira miftuħa, ibgħat sommarju fuq Slack, "
          "u aġġorna d-dashboard tan-Notion",
    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"
        }
    ]
)

Sigurtà u Awtentikazzjoni

# Is-servers MCP jittrattaw l-awtentikazzjoni permezz ta' headers
# jew tokens fil-URL tal-konfigurazzjoni

# L-aħjar prattika: uża dejjem require_approval għal azzjonijiet ta' kitba
tools = [
    {
        "type": "mcp",
        "server_label": "crm",
        "server_url": "https://mcp.example.com/crm",
        "require_approval": "always",  # Validazzjoni umana
        "allowed_tools": ["search_client", "client_profile"],  # Illimita l-għodod
    }
]

Punti Ewlenin

  • L-MCP huwa standard miftuħ biex tgħaqqad il-mudelli ma’ servizzi esterni
  • Il-Konnetturi ta’ OpenAI jintegraw l-MCP direttament fl-API tar-Risposti
  • Ibni s-servers MCP tiegħek stess biex tesponi servizzi interni
  • Uża require_approval biex tikkontrolla l-validazzjoni umana
  • Għaqqad servers MCP multipli f’sejħa waħda għal flussi ta’ xogħol transfunzjonali