MCP i konektori: Povezivanje vanjskih usluga
Na ovoj stranici
Ažurirano 2. studenoga 2026. — Agent Builder. Dana 3. lipnja 2026. OpenAI je najavio gašenje servisa Agent Builder, zakazano za 30. studenoga 2026.; ChatKit ostaje dostupan. Ubuduće, OpenAI korisnike usmjerava na Agents SDK ili agente unutar ChatGPT radnog prostora. Od 10. rujna 2026. OpenAI nudi javnu beta verziju Agents API-ja koja hostira orkestraciju agenata (vidi ChatGPT u 2026., Lekcija 10).
MCP i konektori: Povezivanje vanjskih usluga
Model Context Protocol (MCP) otvoreni je standard koji tvom agentu omogućuje povezivanje s vanjskim uslugama na standardiziran način. Umjesto ponovnog pisanja integracija za svaku uslugu, samo priključiš MCP poslužitelj i tvoj agent trenutno dobiva nove alate. Ondje gdje bi ranije napisao tri stotine redaka koda za GitHub klijent, sada ti treba samo jedna deklaracija poslužitelja.
Što je MCP?
MCP je otvoreni standard koji definira kako klijent—tvoj agent—komunicira sa poslužiteljem, odnosno vanjskom uslugom. Svaki MCP poslužitelj izlaže alate koje tvoj agent može koristiti. Protokol se brine o transportu, serijalizaciji i otkrivanju alata. Ova posljednja značajka najvrjednija je za svakodnevni rad: agent upituje poslužitelj što sve može učiniti, pa ti ne moraš održavati popis. Agents SDK uključuje izvornu podršku za MCP i povezuje se sa svakim kompatibilnim poslužiteljem.
Povezivanje MCP poslužitelja
SDK pruža klasu MCPServerStdio za lokalne poslužitelje koji komuniciraju putem stdin/stdout—obično Node proces pokrenut s npx.
from agents import Agent, Runner
from agents.mcp import MCPServerStdio
# Lokalni MCP poslužitelj (komunicira putem 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 nije samo ukras: on pokreće proces poslužitelja, otkriva njegove alate i uredno ga gasi kada se blok završi. Agent stvoren izvan ovog konteksta neće imati nikakve alate.
Udaljeni MCP poslužitelji putem SSE-a
Za hostirane poslužitelje koristi MCPServerSse i SSE (Server-Sent Events) transport. Logika ostaje ista; mijenjaju se samo URL i zaglavlja za autentifikaciju.
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)
OpenAI konektori
Uz MCP, OpenAI nudi i konektore kojima se upravlja izravno na platformi. Oni se integriraju u Agent Builder i ostaju upotrebljivi putem SDK-a bez potrebe da hostiraš poslužitelj.
from agents import Agent, Runner
# Konektori konfigurirani u Agent Builderu automatski su dostupni
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",
# Konektori su povezani s konfiguracijom agenta na platformi
)
Izostanak parametra mcp_servers ima smisla: konektori su vezani uz konfiguraciju agenta na platformi. Oni umjesto tebe rješavaju OAuth autentifikaciju, paginaciju i ograničenja brzine (rate limiting)—tri područja koja ručno rješavanje oduzimaju znatno vrijeme.
Kombiniranje MCP-a i funkcijskih alata
Ne moraš birati. Jedan agent može koristiti MCP poslužitelj za pristup podacima, a tvoje vlastite funkcije za poslovnu logiku koju ne želiš delegirati.
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 PDV-a ostaje u tvom kodu, gdje je testabilan i podložan reviziji; dohvat narudžbi odvija se putem PostgreSQL MCP poslužitelja. To je podjela kojoj trebaš težiti.
Filtriranje MCP alata
MCP poslužitelj može izložiti desetke alata, od kojih većina neće biti bitna za tvoj slučaj upotrebe—svaki od njih troši kontekst i povećava rizik od neodgovarajućeg poziva. Započni pregledom onoga što je zapravo dostupno.
server = MCPServerStdio(
name="GitHub",
command="npx",
args=["-y", "@modelcontextprotocol/server-github"],
)
# Možeš filtrirati tijekom povezivanja
async with server:
tools = await server.list_tools()
# Pregledaj dostupne alate
for tool in tools:
print(f"- {tool.name}: {tool.description}")
Rukovanje MCP pogreškama
MCP poslužitelj je proces ili udaljena usluga: možda se neće uspjeti pokrenuti, izgubiti vezu ili mu je token istekao. Planiraj degradirani način rada umjesto da dopustiš da se iznimka probije sve do korisnika.
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:
# Povratna opcija bez MCP-a
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
Povratni agent ne glumi da radi: on najavljuje nedostupnost. Agent koji izmišlja odgovor kada je njegov izvor podataka nedostupan košta puno više od onoga koji prizna da ne može nastaviti.
Ključne točke
- MCP je otvoreni protokol za povezivanje vanjskih usluga s tvojim agentom
- Koristi
MCPServerStdioza lokalne poslužitelje, aMCPServerSseza udaljene poslužitelje - OpenAI konektori su integracije kojima se upravlja na platformi
- Možeš kombinirati funkcijske alate i MCP poslužitelje u istom agentu
- Rukuj pogreškama MCP veze pomoću degradiranog načina rada