Ota MCP-palvelin tuotantokäyttöön
Tällä sivulla
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):MCPServerkorvaaFastMCP:n, kuljetusasetukset siirtyvät metodeihinrun()taistreamable_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 vaatiimcp>=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