Konfiguracija oddaljenega strežnika SSE
Na tej strani
Posodobitev 2. novembra 2026 — Le Chat je zdaj Vibe. Od 28. maja 2026 dalje je bil Le Chat preimenovan v Vibe (še vedno na chat.mistral.ai): en sam agent za delo in kodo, ki ohranja vaša pogovora, nastavitve in naročnine. Stara izkušnja Le Chat ostaja na voljo v načinu Chat; v načinu Work so agenti zdaj veščine (priklicane z
@), spomini služijo kot baza znanja, globoko iskanje pa je veščina Deep Research. Načrti se zdaj imenujejo Mistral Free, Pro, Team in Enterprise. Ta lekcija uporablja ime Vibe; nekateri meniji, opisani tukaj, so morda spremenili imena ali lokacije. Dodatek 3. novembra: rezultatirun_asyncse berejo izresult.output_as_text; SDKmistralairazličice 3.7.0 nima atributaoutput.
Posodobitev 2. novembra 2026 — MCP Python SDK v2. Ta tečaj zdaj sledi različici 2 SDK-ja
mcp(2.3.0 od 2. oktobra 2026):MCPServernadomeščaFastMCP, nastavitve prenosa se premaknejo vrun()alistreamable_http_app(), aplikacija, izpostavljena pod pravim imenom gostitelja, pa mora to ime gostitelja deklarirati (transport_security). To je tudi različica, ki jo zahteva Mistral SDK: dodatekmistralai[agents]zahtevamcp>=2.2.0,<3.0. Viri: Kaj je novega v v2 · Vodnik za selitev · Uvajanje in skaliranje.
Prehod z lokalnega na oddaljeno
Do zdaj je vaš strežnik MCP deloval na vašem računalniku in komuniciral prek STDIO. Ta način je idealen za razvoj, vendar izolira vaše delo: nihče drug ga ne more uporabljati, Mistralov Vibe pa na vašem lokalnem računalniku nikoli ne more zagnati procesa. Da bi prestopili to mejo, morate strežnik izpostaviti prek HTTP.
Sprememba je lažja, kot si morda mislite. Oddaljeni strežnik MCP objavi svoja orodja na URL-ju; odjemalec—Vibe, SDK ali IDE—se poveže prek omrežja namesto da bi zagnal proces. Vaša koda orodij sama po sebi ostane nespremenjena.
Strežnik se komaj spremeni
MCPServer samodejno podpira prenos Streamable HTTP. Spodnja datoteka je zapisana popolnoma enako kot lokalni strežnik: isti okrasniki, isti docstringi, isti tipizirani podpisi.
# remote_server.py
"""Oddaljeni strežnik MCP s prenosom HTTP."""
from mcp.server.mcpserver import MCPServer
# Strežnik je enak kot lokalni
app = MCPServer("Remote Demo Server")
@app.tool()
def analyze_text(text: str, language: str = "fr") -> str:
"""Analiziraj besedilo in vrni statistiko.
Args:
text: Besedilo za analizo
language: Koda jezika (fr, en, es). Privzeto: fr
Returns:
Statistika besedila: število besed, znakov, stavkov
"""
words = len(text.split())
chars = len(text)
sentences = text.count(".") + text.count("!") + text.count("?")
return (
f"Language: {language}\n"
f"Words: {words}\n"
f"Characters: {chars}\n"
f"Sentences: {sentences}"
)
@app.tool()
def summarize_key_points(text: str, max_points: int = 5) -> str:
"""Izloči ključne točke iz besedila (poenostavljena različica).
Args:
text: Izvorno besedilo
max_points: Največje število točk za izločitev (1-10)
Returns:
Seznam identificiranih ključnih točk
"""
sentences = [s.strip() for s in text.split(".") if len(s.strip()) > 20]
points = sentences[:max_points]
return "\n".join(f"- {p}" for p in points) if points else "No key points identified."
Edina sprememba je blok zagona, dodan na konec datoteke: prenos HTTP, vrata in seznam imen gostiteljev, ki jih strežnik sprejme.
import os
from mcp.server.transport_security import TransportSecuritySettings
if __name__ == "__main__":
# Javno ime gostitelja, npr. tisto, ki vam ga dodeli ngrok (brez https://)
public_host = os.environ.get("MCP_PUBLIC_HOST")
hosts = ["localhost:*", "127.0.0.1:*"]
if public_host:
hosts += [public_host, f"{public_host}:*"]
app.run(
transport="streamable-http",
port=8000,
transport_security=TransportSecuritySettings(allowed_hosts=hosts),
)
python remote_server.py
Vaš strežnik zdaj posluša na http://localhost:8000/mcp. Seznam allowed_hosts ni podrobnost: SDK v2 privzeto sprejema le zahteve, naslovljene na localhost ali 127.0.0.1, kar je zaščita pred DNS rebindingom. Za tunelom ali pravim domenskim imenom vsaka druga zahteva prejme napako 421 Invalid Host header, ki jo odjemalec prikaže kot splošno napako prenosa; razlog razkrije le dnevnik strežnika.
Pridobivanje javnega URL-ja z ngrok
Če želite svoj strežnik testirati iz Vibea brez popolne uvedbe, ngrok ustvari tunel med javnim URL-jem in vašimi lokalnimi vrati. To orodje skrajša razvojni cikel bolj kot karkoli drugega: spremenite orodje, znova zaženete in oddaljeni konektor takoj vidi novo različico.
# Namestite agenta ngrok s https://ngrok.com/download, nato se avtenticirajte (enkrat)
ngrok config add-authtoken YOUR_NGROK_TOKEN
# Izpostavite vrata 8000
ngrok http 8000
ngrok vam dodeli naslov, kot je https://abc123.ngrok-free.app. Ponovno zaženite strežnik in deklarirajte to ime gostitelja (MCP_PUBLIC_HOST=abc123.ngrok-free.app python remote_server.py). Vaša končna točka MCP postane ta, preprosto z dodajanjem poti /mcp:
https://abc123.ngrok-free.app/mcp
Ta URL dodajte takšen, kot je, v Mistral Vibe kot prilagojeni konektor. Ne pozabite, da je začasen in izpostavlja vaš računalnik: ne puščajte odprtega tunela na strežniku, ki se dotika realnih podatkov.
Povezava odjemalca Python
Na strani odjemalca struktura kode ostane enaka kot v lekciji RunContext. Razlikuje se le razred za povezavo: MCPClientStreamableHTTP s StreamableHTTPServerParams nadomešča par STDIO, vi pa namesto ukaza podate URL.
# remote_client.py
import asyncio
from mistralai.client import Mistral
from mistralai.extra.run.context import RunContext
from mistralai.extra.mcp.streamable_http import (
MCPClientStreamableHTTP,
StreamableHTTPServerParams,
)
async def main():
client = Mistral(api_key="YOUR_API_KEY")
agent = client.beta.agents.create(
model="mistral-medium-latest",
name="remote-assistant",
instructions="You use remote tools to analyze text.",
)
# Poveži se z oddaljenim strežnikom
server_url = "https://abc123.ngrok-free.app/mcp"
mcp_client = MCPClientStreamableHTTP(
params=StreamableHTTPServerParams(
url=server_url,
timeout=100, # Časovna omejitev v sekundah
)
)
async with RunContext(
agent_id=agent.id,
continue_on_fn_error=True,
) as run_ctx:
await run_ctx.register_mcp_client(mcp_client=mcp_client)
result = await client.beta.conversations.run_async(
run_ctx=run_ctx,
inputs="Analyze this text: MCP is an open protocol.",
)
print(result.output_as_text)
asyncio.run(main())
Parameter timeout si zasluži trenutek razmisleka. Pri STDIO so bili klici skoraj trenutni; prek omrežja lahko orodje, ki poizveduje zunanji API ali obdeluje velik dokument, traja več deset sekund. Prekratek časovni limit se kaže kot občasne, težko ponovljive napake, običajno pri najbolj uporabnih zahtevah.
Ko strežnik pričakuje določene glave—žeton API, ključ za usmerjanje, omejitev CORS—jih podate v headers:
mcp_client = MCPClientStreamableHTTP(
params=StreamableHTTPServerParams(
url="https://my-server.example.com/mcp",
timeout=100,
headers={
"Authorization": "Bearer my_api_token",
"X-Custom-Header": "value",
},
)
)
Več strežnikov na enem gostitelju
Lekcija 3 je priporočala osredotočene strežnike namesto kataloga „vse-v-enem”. To priporočilo vas ne obsodi na najem stroja na strežnik: s FastAPI lahko namestite več strežnikov MCP na različne poti istega gostitelja.
# server.py — Več strežnikov MCP na enem gostitelju
from contextlib import asynccontextmanager
from fastapi import FastAPI
from mcp.server.mcpserver import MCPServer
from mcp.server.transport_security import TransportSecuritySettings
# Strežnik MCP za analizo besedila
text_mcp = MCPServer("Text Analysis")
@text_mcp.tool()
def analyze(text: str) -> str:
"""Analiziraj besedilo."""
return f"Words: {len(text.split())}"
# Strežnik MCP za izračune
math_mcp = MCPServer("Math Tools")
@math_mcp.tool()
def calculate(expression: str) -> str:
"""Ovrednoti matematični izraz."""
return str(eval(expression)) # Opozorilo: eval v produkciji!
# Vsak strežnik MCP ustvari samostojno aplikacijo ASGI,
# ki mora vedeti ime gostitelja, pod katerim deluje
security = TransportSecuritySettings(allowed_hosts=["mon-serveur.com", "mon-serveur.com:*"])
text_app = text_mcp.streamable_http_app(transport_security=security)
math_app = math_mcp.streamable_http_app(transport_security=security)
# Skupna življenjska doba: vsak strežnik mora zagnati svoj upravitelj sej
@asynccontextmanager
async def lifespan(app: FastAPI):
async with text_mcp.session_manager.run(), math_mcp.session_manager.run():
yield
api = FastAPI(lifespan=lifespan)
api.mount("/text", text_app)
api.mount("/math", math_app)
Dobili boste dve neodvisni končni točki, https://mon-serveur.com/text/mcp za orodja za analizo besedila in https://mon-serveur.com/math/mcp za matematična orodja, ki ju v Vibeu dodate ločeno. Ključna točka je lifespan: vsak strežnik MCP ima upravitelja sej, ki ga je treba izrecno zagnati. Če aplikacije namestite, ne da bi ta lifespan posredovali FastAPI, bo strežnik odgovoril, vendar bo vsak klic orodja spodletel z napako o neinicializirani nalogi. Uporabnik, ki potrebuje le izračune, ne bo zasmetil svojega konteksta z orodji za besedilo. Opomba pri eval ni šala: na javni končni točki ta vrstica izvrši katero koli kodo, ki jo pošlje klicatelj—to je pedagoški primer, nikoli vzorec za produkcijo.
Še en zadnji refleks: preden svoj URL dodate v pogovor, ga poženite skozi Inspector. Oddaljena končna točka doda vire napak, ki jih lokalni ignorira—zaprt tunel, manjkajoča glava, zasedena vrata—in bolje jih je odkriti zunaj pogovora.
Ključne ugotovitve
- Oddaljeni strežnik MCP izpostavi svoja orodja prek HTTP na končni točki
/mcp - ngrok vam omogoča pridobitev javnega URL-ja za razvoj
MCPClientStreamableHTTPsStreamableHTTPServerParamspoveže odjemalca z oddaljenim strežnikom (MCPClientSSEje zdaj le za stare končne točke/sse)- Parameter timeout je pomemben za počasne strežnike
- Na istem gostitelju FastAPI lahko namestite več strežnikov MCP, pod pogojem, da posredujete njihov lifespan
- Pred integracijo v pogovor vedno testirajte z Inspectorjem