MCP in konektorji: Povezovanje zunanjih storitev
Na tej strani
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 paMCPServerSse - 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