Preskoči na glavni sadržaj
Hrvatski— Odaberite jezik
Izbornik

Uvođenje MCP poslužitelja u proizvodnju

Lekcija 12 od 14 Ažurirano 2. studenoga 2026. Programer
Na ovoj stranici
  1. Od prototipa do produkcijskog poslužitelja
  2. Opcija 1: Hugging Face Spaces
  3. Opcija 2: Docker
  4. Opcije 3 i 4: Upravljana uvođenja
  5. Osiguravanje uvođenja
  6. Uvid u događanja
  7. Ključne točke

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.): MCPServer zamjenjuje FastMCP, postavke transporta prelaze u run() ili streamable_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: dodatak mistralai[agents] zahtijeva mcp>=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