MCP u Konnetturi: Konnessjoni ma' Servizzi Esterni
F'din il-paġna
Aġġornat fit-2 ta’ Novembru, 2026 — Agent Builder. Fit-3 ta’ Ġunju, 2026, OpenAI ħabbret l-għeluq ta’ Agent Builder, skedat għat-30 ta’ Novembru, 2026; ChatKit jibqa’ disponibbli. Minn hawn ‘il quddiem, OpenAI tiddireġġi l-utenti lejn l-SDK tal-Aġenti jew l-aġenti tal-ispazju tax-xogħol ta’ ChatGPT. Mill-10 ta’ Settembru, 2026, OpenAI toffri beta pubblika tal-API tal-Aġenti li tospita l-orkestrazzjoni tal-aġenti (ara ChatGPT fl-2026, Lezzjoni 10).
MCP u Konnetturi: Konnessjoni ma’ Servizzi Esterni
Il-Protokoll tal-Kuntest tal-Mudell (MCP) huwa standard miftuħ li jħalli lill-aġent tiegħek jikkonnettja ma’ servizzi esterni b’mod standardizzat. Minflok ma tikteb mill-ġdid l-integrazzjonijiet għal kull servizz, tikkonnettja server MCP, u l-aġent tiegħek jikseb għodod ġodda istantanjament. Fejn kont tikteb tliet mitt linja ta’ kodiċi klijent ta’ GitHub, issa għandek bżonn biss dikjarazzjoni waħda ta’ server.
X’inhu l-MCP?
L-MCP huwa standard miftuħ li jiddefinixxi kif klijent—l-aġent tiegħek—jikkomunika ma’ server, jiġifieri servizz estern. Kull server MCP jesponi għodod li l-aġent tiegħek jista’ juża. Il-protokoll jimmaniġġja t-trasport, is-serializzazzjoni u s-sejbien tal-għodod. Din l-aħħar karatteristika hija l-aktar prezzjuża għax-xogħol ta’ kuljum: l-aġent jistaqsi lis-server biex jara x’jista’ jagħmel, hekk ma jkollokx bżonn iżżomm lista manwalment. L-SDK tal-Aġenti jinkludi appoġġ nativ għall-MCP u jikkonnettja ma’ kwalunkwe server kompatibbli.
Konnessjoni ta’ Server MCP
L-SDK jipprovdi l-klassi MCPServerStdio għas-servers lokali li jikkunikaw permezz ta’ stdin/stdout—tipikament proċess Node imniedi b’npx.
from agents import Agent, Runner
from agents.mcp import MCPServerStdio
# Server MCP lokali (jikkomunika permezz ta' stdin/stdout)
file_server = MCPServerStdio(
name="File Manager",
command="npx",
args=["-y", "@modelcontextprotocol/server-filesystem", "/path/to/folder"],
)
async def main():
async with file_server:
agent = Agent(
name="File Agent",
instructions="Int timmaniġġja l-fajls għall-utent.",
mcp_servers=[file_server],
)
result = await Runner.run(agent, "Elenska l-fajls fil-folder root.")
print(result.final_output)
Il-blokka async with mhix biss dekorazzjoni: tniedi l-proċess tas-server, tiskopri l-għodod tiegħu, u tagħlaqu sewwa meta l-blokka tintemm. Aġent maħluq barra dan il-kuntest ma jkollu l-ebda għodda.
Servers MCP Remoti permezz ta’ SSE
Għas-servers ospitati, uża MCPServerSse u t-trasport SSE (Server-Sent Events). Il-loġika tibqa’ l-istess; jinbidlu biss l-URL u l-intestazzjonijiet tal-awtentikazzjoni.
from agents.mcp import MCPServerSse
github_server = MCPServerSse(
name="GitHub",
url="https://mcp.github.com/sse",
headers={"Authorization": "Bearer ghp_your_token"},
)
async def main():
async with github_server:
agent = Agent(
name="DevOps Agent",
instructions="Int timmaniġġja r-repożitorji ta' GitHub.",
mcp_servers=[github_server],
)
result = await Runner.run(
agent,
"Oħloq kwistjoni fir-repożitorju my-project bit-titlu 'Critical Bug'"
)
print(result.final_output)
Konnetturi ta’ OpenAI
Barra mill-MCP, OpenAI toffri konnetturi ġestiti direttament fuq il-pjattaforma. Dawn jintegraw f’Agent Builder u jibqgħu użabbli permezz tal-SDK mingħajr ma teħtieġ li tospita server int stess.
from agents import Agent, Runner
# Il-konnetturi kkonfigurati f'Agent Builder huma disponibbli awtomatikament
agent = Agent(
name="CRM Agent",
instructions="""Int assistent tas-CRM. Uża l-konnetturi
biex taċċessa Salesforce, HubSpot, u Google Workspace.""",
model="gpt-5.6-terra",
# Il-konnetturi huma marbuta mal-konfigurazzjoni tal-aġent fuq il-pjattaforma
)
In-nuqqas ta’ parametru mcp_servers jagħmel sens: il-konnetturi huma marbuta mal-konfigurazzjoni tal-aġent fuq il-pjattaforma. Dawn jimmaniġġjaw l-awtentikazzjoni OAuth, il-paġinazzjoni u l-limitazzjoni tar-rata għalik—tliet oqsma li jikkunsmaw ħin konsiderevoli meta jiġu ttrattati manwalment.
Tagħqid ta’ MCP u Għodod ta’ Funzjonijiet
M’għandekx għalfejn tagħżel. Aġent wieħed jista’ juża server MCP għall-aċċess tad-data u l-funzjonijiet tiegħek stess għal-loġika tan-negozju li ma tridx tiddelega.
from agents import Agent, Runner, function_tool
from agents.mcp import MCPServerStdio
@function_tool
def calculate_invoice(amount_excl_tax: float, vat_rate: float = 20.0) -> str:
"""Tikkalkula l-ammont totali inkluża t-taxxa għal fattura."""
amount_incl_tax = amount_excl_tax * (1 + vat_rate / 100)
return f"Eskluża t-taxxa: €{amount_excl_tax}, VAT {vat_rate}%: €{amount_excl_tax * vat_rate / 100:.2f}, Inkluża t-taxxa: €{amount_incl_tax:.2f}"
db_server = MCPServerStdio(
name="Database",
command="npx",
args=["-y", "@modelcontextprotocol/server-postgres", "postgresql://user:pass@localhost/mydb"],
)
async def main():
async with db_server:
agent = Agent(
name="Accounting Agent",
instructions="""Int tittratta l-kontabbiltà.
Uża d-database għad-data tal-klijenti
u l-funzjoni tal-kalkolu għall-fatturi.""",
tools=[calculate_invoice],
mcp_servers=[db_server],
)
result = await Runner.run(
agent,
"Irkupra l-ordnijiet għall-klijent Alice u kkalkula l-fattura totali"
)
print(result.final_output)
Il-kalkolu tal-VAT jibqa’ fil-kodiċi tiegħek, fejn huwa testjabbli u awditjabbli; l-irkupru tal-ordnijiet jgħaddi permezz tas-server PostgreSQL MCP. Din hija s-separazzjoni li għandek timmira lejha.
Iffiltrar tal-Għodod MCP
Server MCP jista’ jesponi għexieren ta’ għodod, li ħafna minnhom ma jkollhomx x’jaqsmu mal-każ ta’ użu tiegħek—u kull waħda minnhom tikkonsma kuntest u żżid ir-riskju ta’ sejħa mhux xierqa. Ibda billi tispezzjona x’inhu disponibbli fil-fatt.
server = MCPServerStdio(
name="GitHub",
command="npx",
args=["-y", "@modelcontextprotocol/server-github"],
)
# Tista' tiffiltra waqt il-konnessjoni
async with server:
tools = await server.list_tools()
# Spezzjona l-għodod disponibbli
for tool in tools:
print(f"- {tool.name}: {tool.description}")
Ġestjoni tal-Iżbalji MCP
Server MCP huwa proċess jew servizz remot: jista’ jonqos milli jibda, jitlif il-konnessjoni tiegħu, jew ikollu token skadut. Ippjana għal modalità degradata minflok ma tħalli l-eċċezzjoni titla’ sal-utent.
from agents.mcp import MCPServerStdio
async def create_agent_with_mcp():
server = MCPServerStdio(
name="External Service",
command="npx",
args=["-y", "my-mcp-server"],
)
try:
async with server:
agent = Agent(
name="My Agent",
instructions="Uża s-servizz estern.",
mcp_servers=[server],
)
result = await Runner.run(agent, "Eżegwixxi l-kompitu.")
return result.final_output
except Exception as e:
# Fallback mingħajr MCP
fallback_agent = Agent(
name="My Agent (modalità degradata)",
instructions="Is-servizz estern mhux disponibbli. Informa lill-utent.",
)
result = await Runner.run(fallback_agent, "Is-servizz mhux disponibbli.")
return result.final_output
L-aġent ta’ fallback ma jippretendix li jaħdem: iħabbar in-nuqqas ta’ disponibbiltà. Aġent li jinventa tweġiba meta s-sors tad-data tiegħu ma jaħdimx jiswaf ferm aktar minn wieħed li jammetti li ma jistax ikompli.
Punti Ewlenin
- L-MCP huwa protokoll miftuħ biex tikkonnettja servizzi esterni mal-aġent tiegħek
- Uża
MCPServerStdiogħas-servers lokali uMCPServerSsegħas-servers remoti - Il-Konnetturi ta’ OpenAI huma integrazzjonijiet ġestiti fuq il-pjattaforma
- Tista’ tgħaqqad għodod ta’ funzjonijiet u servers MCP fl-istess aġent
- Immaniġġja l-iżbalji tal-konnessjoni MCP b’modalità degradata