Preskok na glavno vsebino
Slovenščina— Izberite jezik
Meni

MCP in konektorji: Povezovanje zunanjih storitev

Lekcija 9 od 25 Posodobljeno 2. november 2026 Razvijalec
Na tej strani
  1. MCP in konektorji: Povezovanje zunanjih storitev
  2. Kaj je MCP?
  3. Povezava s strežnikom MCP
  4. Oddaljeni strežniki MCP prek SSE
  5. Konektorji OpenAI
  6. Združevanje orodij MCP in funkcij
  7. Filtriranje orodij MCP
  8. Obravnava napak MCP
  9. Ključne ugotovitve

Posodobljeno 2. novembra 2026 — Agent Builder. 3. junija 2026 je OpenAI napovedal ukinitev storitve Agent Builder, načrtovano za 30. november 2026; ChatKit ostaja na voljo. V prihodnje OpenAI uporabnike usmerja k Agents SDK ali agentom delovnega prostora ChatGPT. Od 10. septembra 2026 dalje OpenAI ponuja javno beta različico Agents API, ki gosti orkestracijo agentov (glej ChatGPT leta 2026, lekcija 10).

MCP in konektorji: Povezovanje zunanjih storitev

Protokol za kontekst modela (MCP) je odprt standard, ki vašemu agentu omogoča povezavo z zunanjimi storitvami na standardiziran način. Namesto da bi za vsako storitev znova pisali integracije, preprosto priključite strežnik MCP in vaš agent takoj pridobi nova orodja. Tam, kjer bi sicer napisali tristo vrstic kode odjemalca za GitHub, zdaj potrebujete le eno samo deklaracijo strežnika.

Kaj je MCP?

MCP je odprt standard, ki opredeljuje način komunikacije med odjemalcem (vašim agentom) in strežnikom (zunanjo storitvijo). Vsak strežnik MCP izpostavlja orodja, ki jih vaš agent lahko uporablja. Protokol obravnava prenos podatkov, serializacijo in odkrivanje orodij. Prav zadnja lastnost je za vsakodnevno delo najbolj dragocena: agent poizveduje pri strežniku, kaj vse zmore, zato vam ni treba vzdrževati seznama orodij. Agents SDK vključuje nativno podporo za MCP in se poveže s katerim koli združljivim strežnikom.

Povezava s strežnikom MCP

SDK zagotavlja razred MCPServerStdio za lokalne strežnike, ki komunicirajo prek stdin/stdout – običajno gre za proces Node, zagnan z ukazom npx.

from agents import Agent, Runner
from agents.mcp import MCPServerStdio

# Lokalni strežnik MCP (komunikacija prek 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="You manage files for the user.",
            mcp_servers=[file_server],
        )
        result = await Runner.run(agent, "List the files in the root folder.")
        print(result.final_output)

Blok async with ni zgolj okras: zažene proces strežnika, odkrije njegova orodja in ga ob izhodu iz bloka pravilno izklopi. Agent, ustvarjen zunaj tega konteksta, ne bo imel na voljo nobenih orodij.

Oddaljeni strežniki MCP prek SSE

Za gostovane strežnike uporabite MCPServerSse in prenosni mehanizem SSE (Server-Sent Events). Logika ostaja enaka; spremenita se le URL in glave za avtentikacijo.

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="You manage GitHub repositories.",
            mcp_servers=[github_server],
        )
        result = await Runner.run(
            agent,
            "Create an issue in the my-project repo with the title 'Critical Bug'"
        )
        print(result.final_output)

Konektorji OpenAI

Poleg MCP OpenAI ponuja tudi konektorje, ki jih neposredno upravlja platforma. Ti so integrirani v Agent Builder in ostajajo uporabni prek SDK, ne da bi morali gostovati lasten strežnik.

from agents import Agent, Runner

# Konektorji, konfigurirani v Agent Builder, so samodejno na voljo
agent = Agent(
    name="CRM Agent",
    instructions="""You are a CRM assistant. Use the connectors
    to access Salesforce, HubSpot, and Google Workspace.""",
    model="gpt-5.6-terra",
    # Konektorji so povezani s konfiguracijo agenta na platformi
)

Odsotnost parametra mcp_servers je smiselna: konektorji so vezani na konfiguracijo agenta na platformi. Namesto vas obravnavajo avtentikacijo OAuth, paginacijo in omejevanje hitrosti (rate limiting) – tri področja, ki ob ročnem upravljanju porabijo veliko časa.

Združevanje orodij MCP in funkcij

Ni vam treba izbirati med enim ali drugim. En sam agent lahko uporablja strežnik MCP za dostop do podatkov in vaše lastne funkcije za poslovno logiko, ki je ne želite prepustiti zunanjim storitvam.

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:
    """Calculates the total amount including tax for an invoice."""
    amount_incl_tax = amount_excl_tax * (1 + vat_rate / 100)
    return f"Excl. tax: €{amount_excl_tax}, VAT {vat_rate}%: €{amount_excl_tax * vat_rate / 100:.2f}, Incl. tax: €{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="""You handle accounting.
            Use the database for customer data
            and the calculation function for invoices.""",
            tools=[calculate_invoice],
            mcp_servers=[db_server],
        )
        result = await Runner.run(
            agent,
            "Retrieve orders for customer Alice and calculate the total invoice"
        )
        print(result.final_output)

Izračun DDV ostane v vaši kodi, kjer je testirljiv in revidiran; pridobivanje naročil pa poteka prek strežnika MCP za PostgreSQL. To je razdelitev, h kateri bi morali težiti.

Filtriranje orodij MCP

Strežnik MCP lahko izpostavi na desetine orodij, od katerih večina za vaš primer uporabe ne bo pomembna – vsako od njih pa porabi kontekst in poveča tveganje za neustrezen klic. Začnite s pregledom dejansko razpoložljivih orodij.

server = MCPServerStdio(
    name="GitHub",
    command="npx",
    args=["-y", "@modelcontextprotocol/server-github"],
)

# Filtrirate lahko med povezavo
async with server:
    tools = await server.list_tools()
    # Pregled razpoložljivih orodij
    for tool in tools:
        print(f"- {tool.name}: {tool.description}")

Obravnava napak MCP

Strežnik MCP je proces ali oddaljena storitev: lahko se ne zažene, izgubi povezavo ali pa mu poteče žeton. Načrtujte način delovanja z omejeno funkcionalnostjo (degraded mode), namesto da bi dovolili, da se izjema prenese vse do uporabnika.

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="Use the external service.",
                mcp_servers=[server],
            )
            result = await Runner.run(agent, "Execute the task.")
            return result.final_output
    except Exception as e:
        # Nadomestni način brez MCP
        fallback_agent = Agent(
            name="My Agent (degraded mode)",
            instructions="The external service is unavailable. Inform the user.",
        )
        result = await Runner.run(fallback_agent, "The service is unavailable.")
        return result.final_output

Nadomestni agent se ne pretvarja, da deluje: sporoči nedostopnost storitve. Agent, ki si izmisli odgovor, ko je njegov vir podatkov nedostopen, stane veliko več kot tisti, ki prizna, da ne more nadaljevati.

Ključne ugotovitve

  • MCP je odprt protokol za povezovanje zunanjih storitev z vašim agentom
  • Za lokalne strežnike uporabite MCPServerStdio, za oddaljene pa MCPServerSse
  • Konektorji OpenAI so integracije, ki jih upravlja platforma
  • V istem agentu lahko združite funkcijska orodja in strežnike MCP
  • Napake pri povezavi z MCP obravnavajte z načinom delovanja z omejeno funkcionalnostjo