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

MCP u Konnetturi: Konnessjoni ma' Servizzi Esterni

Lezzjoni 9 / 25 Aġġornat 2 ta’ Novembru 2026 Zviluppatur
F'din il-paġna
  1. MCP u Konnetturi: Konnessjoni ma’ Servizzi Esterni
  2. X’inhu l-MCP?
  3. Konnessjoni ta’ Server MCP
  4. Servers MCP Remoti permezz ta’ SSE
  5. Konnetturi ta’ OpenAI
  6. Tagħqid ta’ MCP u Għodod ta’ Funzjonijiet
  7. Iffiltrar tal-Għodod MCP
  8. Ġestjoni tal-Iżbalji MCP
  9. Punti Ewlenin

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 MCPServerStdio għas-servers lokali u MCPServerSse għ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