Siirry pääsisältöön
Suomi— Valitse kieli
Valikko

Ota MCP-palvelin tuotantokäyttöön

Oppitunti 12 / 14 Päivitetty 2. marraskuuta 2026 Kehittäjä
Tällä sivulla
  1. Prototyypistä tuotantopalvelimeksi
  2. Vaihtoehto 1: Hugging Face Spaces
  3. Vaihtoehto 2: Docker
  4. Vaihtoehdot 3 ja 4: Hallitut käyttöönotot
  5. Käyttöönoton suojaaminen
  6. Tilanteen seuraaminen
  7. Keskeiset asiat

Päivitys 2. marraskuuta 2026 — Le Chat on nyt Vibe. 28. toukokuuta 2026 lähtien Le Chat on uudelleenbrändätty nimelle Vibe (osoitteessa chat.mistral.ai): yksi agentti työhön ja koodaukseen, joka säilyttää keskustelusi, asetuksesi ja tilauksesi. Vanha Le Chat -kokemus on edelleen käytettävissä Chat-tilassa; Work-tilassa agentit ovat nyt taitoja (kutsutaan merkillä @), muistit muodostavat tietopohjan ja syvällinen tutkimus on Deep Research -taito. Suunnitelmat ovat nyt nimeltään Mistral Free, Pro, Team ja Enterprise. Tässä oppitunnissa käytetään nimeä Vibe; jotkin tässä kuvatut valikot voivat olla muuttaneet nimeään tai sijaintiaan.

Päivitys 2. marraskuuta 2026 — MCP Python SDK v2. Tämä kurssi seuraa nyt mcp-SDK:n versiota 2 (2.3.0 päivätty 2. lokakuuta 2026): MCPServer korvaa FastMCP:n, kuljetusasetukset siirtyvät metodeihin run() tai streamable_http_app(), ja oikean isäntänimen alla julkaistun sovelluksen on ilmoitettava tuo isäntänimi (transport_security). Tämä on myös Mistral SDK:n vaatima versio: mistralai[agents]-lisäosa vaatii mcp>=2.2.0,<3.0. Lähteet: Mitä uutta versiossa v2 · Migraatio-opas · Käyttöönotto ja skaalaus.

Prototyypistä tuotantopalvelimeksi

Palvelimesi toimii paikallisesti, ja ngrok paljastaa sen maailmalle vain demoa varten. Ongelma alkaa, kun joku muu tarvitsee sitä: suljet päätteesi, URL-osoite kuolee, ja kaikki kollegoidesi määrittämät liittymät hajoavat. Tuotantoon siirtyminen tarkoittaa pohjimmiltaan vakaan osoitteen hankkimista, joka on saatavilla 24/7 ja tarjoillaan HTTPS:n yli. Neljä vaihtoehtoa vievät sinut sinne, nopeimmasta hallituimpaan. Valintasi riippuu pääasiassa datasi arkaluonteisuudesta ja siitä, kuinka paljon haluat hallita infrastruktuuria.

Vaihtoehto 1: Hugging Face Spaces

Hugging Face Spaces tarjoaa ilmaisia virtuaalikoneita ilman näytönohjaimia, mikä riittää hyvin MCP-palvelimelle, joka välittää API-kutsuja. Tämä on nopein reitti todelliseen käyttöönottoon: kolme tiedostoa ja git push.

mon-mcp-space/
├── app.py              # FastAPI + MCP-palvelin
├── requirements.txt    # Riippuvuudet
└── README.md           # Spacen metadata

Tiedosto app.py noudattaa tarkalleen samaa rakennetta kuin olet nähnyt tähän asti, paitsi että arkaluonteiset arvot luetaan ympäristöstä – HF Secrets injektoidaan sinne:

# app.py
"""MCP-palvelin otettu käyttöön Hugging Face Spacesissa."""

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:
    """Tervehdi henkilöä.

    Args:
        name: Henkilön etunimi

    Returns:
        Tervehdysviesti
    """
    return f"Hello {name} from Hugging Face Spaces!"

@asynccontextmanager
async def lifespan(app: FastAPI):
    async with mcp.session_manager.run():
        yield

# Spacen isäntänimi muodossa <käyttäjä>-<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))

# Arkaluonteisia muuttujia varten käytä HF Secrets -palvelua
API_KEY = os.environ.get("MY_API_KEY", "")

Alustan erikoisuus piilee README-tiedostossa, jonka YAML-otsake ohjaa Spacen buildia. Kentän app_port on vastattava porttia, jota palvelimesi todella kuuntelee; muuten käyttöönotto onnistuu, mutta palvelin jää saavuttamattomiin:

---
title: My MCP Server
emoji: 🔧
colorFrom: blue
colorTo: green
sdk: docker
app_port: 7860
---
# Luo Space osoitteessa huggingface.co
# Työnnä koodi
git push
# Space otetaan käyttöön automaattisesti

Päätepisteesi on sitten muotoa https://your-username-mon-mcp-space.hf.space/mcp-endpoint/mcp, ja se tarjoillaan HTTPS:n yli. Yksi konfigurointivaihe on vielä jäljellä: ilmoita tämä isäntänimi, your-username-mon-mcp-space.hf.space, muuttujassa MCP_PUBLIC_HOST Spacen asetuksissa. Ilman sitä SDK hylkää jokaisen pyynnön virheellä 421 Invalid Host header.

Vaihtoehto 2: Docker

Heti kun palvelin koskettaa sisäistä dataa, omassa infrastruktuurissa hostaamisesta tulee sääntö, ja Docker on standardimuoto. Dockerfile vaatii vain muutaman ohjeen, ja riippuvuuksien asennus sijoitetaan ennen koodin kopiointia hyödyntämään kerros välimuistia uudelleenrakennuksissa:

FROM python:3.12-slim

WORKDIR /app

# Asenna riippuvuudet
COPY requirements.txt .
RUN pip install --no-cache-dir -r requirements.txt

# Kopioi koodi
COPY . .

# Paljasta portti
EXPOSE 8000

# Käynnistä palvelin
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   # vain jos työkalusi käyttävät sitä: SDK v2 ei enää asenna sitä

Käynnistyksen yhteydessä vaihtoehto --restart unless-stopped on se, mikä erottaa tuotantokäyttöönoton yksinkertaisesta testistä: ilman sitä ensimmäinen kaatuminen vie palvelimesi offline-tilaan, kunnes joku huomaa sen.

# Rakenna image
docker build -t mon-mcp-server .

# Suorita kontti
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 tekee tästä konfiguraatiosta toistettavan ja lisää terveystarkistuksen, jota orkestroija käyttää havaitakseen jäätyneen palvelimen – elävä prosessi, joka ei enää vastaa, on skenaario, jota yksinkertaiset automaattiset uudelleenkäynnistykset eivät kata:

# 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

Vaihtoehdot 3 ja 4: Hallitut käyttöönotot

Prefect Horizon (aiemmin FastMCP Cloud), riippumattoman FastMCP-kehyksen takana olevan tiimin alusta, poistaa infrastruktuurivaiheen: kirjaudut osoitteeseen horizon.prefect.io GitHub-tililläsi, valitset repositorion ja palvelintiedoston, ja alusta rakentaa ja julkaisee URL-osoitteen sisäänrakennetulla tunnistautumisella. Se kohdistuu kyseisellä kehyksellä kirjoitettuihin palvelimiin (pip install fastmcp, from fastmcp import FastMCP), mikä eroaa tässä kurssissa käytetystä virallisesta SDK:sta; henkilökohtaisiin projekteihin on olemassa ilmainen taso.

Cloudflare Workers kohdistuu erilaiseen käyttöprofiiliin: serverless, suoritus mahdollisimman lähellä käyttäjää ja siten pienempi viive. Erillinen malli käynnistää projektin:

# Käytä Cloudflaren MCP-mallia
npm create cloudflare@latest -- remote-mcp-server-authless --template=cloudflare/ai/demos/remote-mcp-authless

Molemmat vaihtoehdot säästävät sinut varmenteiden ja uudelleenkäynnistysten hallinnalta, mutta alustariippuvuuden ja suoritusrajoitusten hinnalla – serverless-Worker ei esimerkiksi sovi hyvin yhteen tilaa ylläpitävän palvelimen kanssa.

Käyttöönoton suojaaminen

HTTPS on ehdoton: Vibe kieltäytyy selvätekstisistä päätepisteistä, ja HTTP:n yli kulkeva token on kompromissoitunut token. Kolme polkua johtaa sinne isännöinnistäsi riippuen. Käänteinen välityspalvelin kuten Nginx tai Caddy palvelimesi edessä Let’s Encrypt -varmenteella kattaa omistetun palvelimen tapauksen. Pilvinatiivit alustat – Hugging Face, Cloudflare ja useimmat PaaS-tarjoajat – tarjoavat HTTPS:n automaattisesti. Tunneli, kuten Cloudflare Tunnel, paljastaa sisäverkossasi pysyvän palvelimen avaamatta portteja.

Yhtään salaista arvoa ei saa esiintyä koodissa. Huomaa ero alla olevien kahden syntaksin välillä: os.environ["MCP_API_TOKEN"] aiheuttaa käynnistyksen epäonnistumisen, jos muuttuja puuttuu, mikä on juuri haluttu käyttäytyminen pakolliselle salaisuudelle, kun taas os.environ.get() sietää puuttumista valinnaisille arvoille.

import os

# Konfiguraatio ympäristömuuttujien kautta
API_TOKEN = os.environ["MCP_API_TOKEN"]       # Pakollinen
DATABASE_URL = os.environ.get("DATABASE_URL")  # Valinnainen
DEBUG = os.environ.get("DEBUG", "false") == "true"

Julkinen palvelin ilman nopeusrajoitusta kyllästyy ennemmin tai myöhemmin, tahallaan tai vahingossa. IP-pohjainen rajoitin riittää useimmissa tapauksissa:

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 pyyntöä minuutissa IP-osoitetta kohti
    ...

Tilanteen seuraaminen

Tuotannossa sinulla ei ole enää päätettä edessäsi, ja työkalua, joka epäonnistuu joka kymmenes kerta, voidaan diagnosoida vain jäljitysten avulla. Instrumentoi vähintään jokaisen kutsun syöte, tuloste ja kesto:

import logging
import time

logger = logging.getLogger("mcp-server")

@mcp.tool()
async def my_tool(param: str) -> str:
    """Työkaluni lokituksella."""
    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

Keston mittaaminen ei ole ylellisyyttä: työkalu, joka vastaa kahdessatoista sekunnissa, laukaisee asiakaspuolen aikakatkaisut ja antaa vaikutelman rikkoutuneesta palvelimesta, vaikka se todellisuudessa toimisi. Ennen kuin ilmoitat palvelimestasi, käy läpi seuraavat kuusi konfiguraatiokohtaa.

  • HTTPS aktiivinen ja varmenne voimassa
  • Ympäristömuuttujat kaikille salaisuuksille
  • Jäsennelty lokitus käytössä
  • Terveystarkistuspäätepiste (/ tai /health)
  • Automaattinen uudelleenkäynnistys kaatumisen yhteydessä
  • Nopeusrajoitus konfiguroitu

Jäljellä on kaksi tarkistusta, ne joita ihmiset useimmiten ohittavat, mutta jotka paljastavat todelliset ongelmat: testi MCP Inspectorilla käynnistettynä ulkopuolelta, sitten testi Mistral Vibestä. Palvelin, joka vastaa täydellisesti omalta koneeltasi, voidaan estää palomuurilla tai CORS-konfiguraatiolla heti, kun sitä kutsutaan muualta.

Keskeiset asiat

  • Hugging Face Spaces: nopein, ilmainen, ihanteellinen aloittamiseen
  • Docker: täysi hallinta, sopii omistettuihin palvelimiin ja pilveen
  • Prefect Horizon (ex-FastMCP Cloud): käyttöönotto GitHubista, FastMCP-kehyksellä kirjoitetuille palvelimille
  • Cloudflare Workers: serverless, pieni viive, skaalautuva
  • Suojaa HTTPS:llä, ympäristömuuttujilla ja nopeusrajoituksella
  • Lisää monitorointi ja lokit tuotantovianetsintää varten