MCP u l-Konnetturi: L-Istandard Universali
F'din il-paġna
- MCP u l-Konnetturi: L-Istandard Universali
- Il-Problema li Solva l-MCP
- L-Arkitettura tal-MCP
- L-Użu tal-Konnetturi ta’ OpenAI
- Il-Ħolqien ta’ Server MCP f’Python
- L-Espożizzjoni tar-Riżorsi MCP
- Il-Konnessjoni ta’ Server MCP mal-API tar-Risposti
- Mudell: Ċentru Multi-Konnettur
- Sigurtà u Awtentikazzjoni
- 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_approvalbiex tikkontrolla l-validazzjoni umana - Għaqqad servers MCP multipli f’sejħa waħda għal flussi ta’ xogħol transfunzjonali