Uvođenje MCP poslužitelja u proizvodnju
Na ovoj stranici
Ažuriranje 2. studenoga 2026. — Le Chat sada je Vibe. Od 28. svibnja 2026., Le Chat je rebrendiran u Vibe (i dalje na chat.mistral.ai): jedan agent za posao i kod koji prenosi tvoje razgovore, postavke i pretplate. Legacy iskustvo Le Chata ostaje dostupno u načinu Chat; u načinu Work, agenti su sada vještine (pozivaju se s
@), memorije čine bazu znanja, a dubinsko istraživanje je vještina Deep Research. Planovi se sada nazivaju Mistral Free, Pro, Team i Enterprise. Ova lekcija koristi naziv Vibe; neki izbornici opisani ovdje možda su promijenili nazive ili lokacije.
Ažuriranje 2. studenoga 2026. — MCP Python SDK v2. Ovaj tečaj sada prati verziju 2 SDK-a
mcp(2.3.0 od 2. listopada 2026.):MCPServerzamjenjujeFastMCP, postavke transporta prelaze urun()ilistreamable_http_app(), a aplikacija izložena pod stvarnim imenom hosta mora deklarirati to ime hosta (transport_security). Ovo je također verzija koju zahtijeva Mistral SDK: dodatakmistralai[agents]zahtijevamcp>=2.2.0,<3.0. Izvori: Što je novo u v2 · Vodič za migraciju · Uvođenje i skaliranje.
Od prototipa do produkcijskog poslužitelja
Tvoj poslužitelj radi lokalno, a ngrok ga izlaže svijetu samo za demonstraciju. Problem nastaje kada ga netko drugi treba koristiti: zatvoriš terminal, URL umire i svaki konektor koji su tvoje kolege konfigurirale puca. Prelazak u proizvodnju u biti znači dobivanje stabilne adrese, dostupne 24/7, servirane preko HTTPS-a. Četiri opcije vode te do toga, od najbrže do one s najviše kontrole. Tvoj izbor uglavnom ovisi o tome koliko su tvoji podaci osjetljivi i koliko kontrole želiš imati nad infrastrukturom.
Opcija 1: Hugging Face Spaces
Hugging Face Spaces pruža besplatna virtualna strojeva bez GPU-ova, što je više nego dovoljno za MCP poslužitelj koji prosljeđuje API pozive. Ovo je najbrži put do stvarnog uvođenja: tri datoteke i git push.
mon-mcp-space/
├── app.py # FastAPI + MCP poslužitelj
├── requirements.txt # Ovisnosti
└── README.md # Metapodaci Spacea
Datoteka app.py slijedi točnu strukturu koju si do sada vidio, osim što se osjetljive vrijednosti čitaju iz okoline—HF Secrets ih tamo ubacuju:
# app.py
"""MCP poslužitelj uveden na Hugging Face Spaces."""
import os
from contextlib import asynccontextmanager
from fastapi import FastAPI
from mcp.server.mcpserver import MCPServer
from mcp.server.transport_security import TransportSecuritySettings
mcp = MCPServer("My Production Server")
@mcp.tool()
def hello(name: str) -> str:
"""Pozdravi osobu.
Args:
name: Ime osobe
Returns:
Poruka pozdrava
"""
return f"Hello {name} from Hugging Face Spaces!"
@asynccontextmanager
async def lifespan(app: FastAPI):
async with mcp.session_manager.run():
yield
# Hostname Spacea, u obliku <korisnik>-<space>.hf.space
SPACE_HOST = os.environ.get("MCP_PUBLIC_HOST", "localhost")
security = TransportSecuritySettings(allowed_hosts=[SPACE_HOST, f"{SPACE_HOST}:*"])
api = FastAPI(lifespan=lifespan)
api.mount("/mcp-endpoint", mcp.streamable_http_app(transport_security=security))
# Za osjetljive varijable koristi HF Secrets
API_KEY = os.environ.get("MY_API_KEY", "")
Specifičnost platforme leži u README-u, čiji YAML zaglavlje pokreće izgradnju Spacea. Polje app_port mora odgovarati portu na kojem tvoj poslužitelj stvarno sluša; u suprotnom, uvođenje uspijeva, ali ostaje nedostupno:
---
title: My MCP Server
emoji: 🔧
colorFrom: blue
colorTo: green
sdk: docker
app_port: 7860
---
# Stvori Space na huggingface.co
# Gurni kod
git push
# Space se automatski uvodi
Tvoja krajnja točka tada postaje https://your-username-mon-mcp-space.hf.space/mcp-endpoint/mcp, servirana preko HTTPS-a. Preostaje jedan korak konfiguracije: deklariraj ovaj hostname, your-username-mon-mcp-space.hf.space, u varijabli MCP_PUBLIC_HOST u postavkama Spacea. Bez toga, SDK odbija svaki zahtjev s greškom 421 Invalid Host header.
Opcija 2: Docker
Čim poslužitelj dotakne interne podatke, hosting na vlastitoj infrastrukturi postaje pravilo, a Docker je standardni format. Dockerfile zahtijeva samo nekoliko instrukcija, pri čemu je instalacija ovisnosti postavljena prije kopiranja koda kako bi se iskoristilo keširanje slojeva tijekom ponovnih izgradnji:
FROM python:3.12-slim
WORKDIR /app
# Instaliraj ovisnosti
COPY requirements.txt .
RUN pip install --no-cache-dir -r requirements.txt
# Kopiraj kod
COPY . .
# Izloži port
EXPOSE 8000
# Pokreni poslužitelj
CMD ["uvicorn", "server:api", "--host", "0.0.0.0", "--port", "8000"]
fastapi>=0.115.0
uvicorn>=0.30.0
mcp>=2.2,<3
httpx>=0.27.0 # samo ako tvoji alati to koriste: SDK v2 ga više ne instalira
Pri pokretanju, opcija --restart unless-stopped je ono što razlikuje produkcijsko uvođenje od jednostavnog testa: bez nje, prvi crash gasi tvoj poslužitelj dok ga netko ne primijeti.
# Izgradi sliku
docker build -t mon-mcp-server .
# Pokreni kontejner
docker run -d \
--name mcp-server \
-p 8000:8000 \
-e MY_API_KEY="secret" \
-e DATABASE_URL="postgresql://..." \
--restart unless-stopped \
mon-mcp-server
Docker Compose čini ovu konfiguraciju reproducibilnom i dodaje zdravstvenu provjeru (health check), koju orchestrator koristi za otkrivanje zamrznutog poslužitelja—živ proces koji više ne odgovara scenarij je koji jednostavna automatska ponovna pokretanja ne pokrivaju:
# docker-compose.yml
version: "3.8"
services:
mcp-server:
build: .
ports:
- "8000:8000"
environment:
- MY_API_KEY=${MY_API_KEY}
- DATABASE_URL=${DATABASE_URL}
restart: unless-stopped
healthcheck:
test: ["CMD", "curl", "-f", "http://localhost:8000/"]
interval: 30s
retries: 3
Opcije 3 i 4: Upravljana uvođenja
Prefect Horizon (ranije FastMCP Cloud), platforma tima iza nezavisnog frameworka FastMCP, uklanja korak infrastrukture: prijaviš se na horizon.prefect.io svojim GitHub računom, odabereš repozitorij i datoteku poslužitelja, a platforma gradi i objavljuje URL s ugrađenom autentifikacijom. Cilja poslužitelje napisane s tim frameworkom (pip install fastmcp, from fastmcp import FastMCP), što je različito od službenog SDK-a korištenog u ovom tečaju; besplatna razina postoji za osobne projekte.
Cloudflare Workers cilja drugačiji profil upotrebe: serverless, s izvršavanjem najbližim korisniku i time smanjenom latencijom. Namjenski predložak pokreće projekt:
# Koristi Cloudflareov MCP predložak
npm create cloudflare@latest -- remote-mcp-server-authless --template=cloudflare/ai/demos/remote-mcp-authless
Obje opcije štede ti upravljanje certifikatima i ponovnim pokretanjima, uz cijenu ovisnosti o platformi i ograničenja izvršavanja—serverless Worker, na primjer, ne slaže se dobro sa poslužiteljem koji održava stanje (stateful).
Osiguravanje uvođenja
HTTPS nije pregovarački: Vibe odbija plaintext krajnje točke, a token koji putuje preko HTTP-a je kompromitirani token. Tri puta vode tamo, ovisno o tvom hostingu. Obrnuti proxy poput Nginxa ili Caddyja postavljen ispred tvog poslužitelja, s Let’s Encrypt certifikatom, pokriva slučaj namjenskog poslužitelja. Cloud-native platforme—Hugging Face, Cloudflare i većina PaaS pružatelja—automatski pružaju HTTPS. Tunel, poput Cloudflare Tunela, izlaže poslužitelj koji ostaje na tvojoj internoj mreži bez otvaranja portova.
Nijedna tajna ne smije se pojaviti u kodu. Primijeti razliku između dviju sintaksi u nastavku: os.environ["MCP_API_TOKEN"] uzrokuje neuspjeh pokretanja ako varijabla nedostaje, što je točno željeno ponašanje za obaveznu tajnu, dok os.environ.get() tolerira odsutnost za opcionalne vrijednosti.
import os
# Konfiguracija putem varijabli okoline
API_TOKEN = os.environ["MCP_API_TOKEN"] # Obavezno
DATABASE_URL = os.environ.get("DATABASE_URL") # Opcionalno
DEBUG = os.environ.get("DEBUG", "false") == "true"
Javni poslužitelj bez ograničenja stope (rate limiting) eventualno će biti zasićen, namjerno ili ne. Ograničivač temeljen na IP adresi u većini slučajeva je dovoljan:
from fastapi import FastAPI, Request
from slowapi import Limiter, _rate_limit_exceeded_handler
limiter = Limiter(key_func=lambda request: request.client.host)
api = FastAPI()
api.state.limiter = limiter
@api.middleware("http")
async def rate_limit(request: Request, call_next):
# 100 zahtjeva po minuti po IP adresi
...
Uvid u događanja
U proizvodnji više nemaš terminal ispred sebe, a alat koji zakaže jedanput od deset može se dijagnosticirati samo tragovima (traces). Kao minimum, instrumentiraj ulaz, izlaz i trajanje svakog poziva:
import logging
import time
logger = logging.getLogger("mcp-server")
@mcp.tool()
async def my_tool(param: str) -> str:
"""Moj alat s bilježenjem."""
start = time.time()
logger.info(f"Tool called with param={param}")
try:
result = await process(param)
duration = time.time() - start
logger.info(f"Tool finished in {duration:.2f}s")
return result
except Exception as e:
logger.error(f"Error in tool: {e}")
raise
Mjerenje trajanja nije luksuz: alat kojem treba dvanaest sekundi za odgovor pokreće istek vremena (timeout) na strani klijenta i stvara dojam pokvarenog poslužitelja kada on zapravo radi. Prije najave svog poslužitelja, pregledaj sljedećih šest točaka konfiguracije.
- HTTPS aktivan i valjani certifikat
- Varijable okoline za sve tajne
- Omogućeno strukturirano bilježenje (logging)
- Krajnja točka za zdravstvenu provjeru (
/ili/health) - Automatsko ponovno pokretanje pri crashu
- Konfigurirano ograničenje stope (rate limiting)
Preostaju dvije provjere, one koje ljudi najčešće preskoče, a koje otkrivaju stvarne probleme: test s MCP Inspectorom pokrenutim izvana, zatim test iz Mistral Vibe. Poslužitelj koji savršeno odgovara s tvog stroja može biti blokiran vatrozidom ili CORS konfiguracijom čim ga se pozove s drugog mjesta.
Ključne točke
- Hugging Face Spaces: najbrže, besplatno, idealno za početak
- Docker: potpuna kontrola, prikladno za namjenske poslužitelje i cloud
- Prefect Horizon (bivši FastMCP Cloud): uvođenje s GitHuba, za poslužitelje napisane s FastMCP frameworkom
- Cloudflare Workers: serverless, niska latencija, skalabilno
- Osiguraj s HTTPS-om, varijablama okoline i ograničenjem stope
- Dodaj nadzor i zapise za otklanjanje grešaka u proizvodnji