MCP server a Model Context Protocol — návod

Co je Model Context Protocol

Model Context Protocol (MCP) je otevřený standard pro propojení AI asistentů s externími nástroji a daty. Klient (Claude Code, Claude Desktop, IDE, vlastní agent) se připojí k MCP serveru, zjistí, co server nabízí, a model pak tyto schopnosti volá. Jeden server tak slouží všem klientům, kteří protokol podporují. Pro širší koncepty vývoje AI viz Vývoj AI .

Kdy ho použít

• Model má pracovat s vlastním systémem — databází, CMS, ticketovacím systémem, interním API
• Stejnou integraci má používat víc klientů nebo agentů
• Ladíte spojení mezi MCP klientem a serverem
• Rozhodujete, zda má být nová schopnost nástroj, zdroj, nebo prompt

Architektura

• Host — aplikace, ve které běží model (Claude Code, IDE, chatovací aplikace).
• Klient — část hostu, která drží spojení s jedním serverem. Na každý server jeden klient.
• Server — program, který nabízí schopnosti. Zprávy jsou JSON-RPC 2.0.

Server nabízí tři druhy schopností:

Klient může serveru naopak nabídnout sampling (server požádá o vygenerování textu modelem), roots (adresáře, se kterými smí pracovat) a elicitation (dotaz na uživatele).

Transporty

• stdio — klient spustí server jako podproces a komunikuje přes standardní vstup a výstup. Pro lokální nástroje; žádná síť ani autentizace.
• Streamable HTTP — server běží samostatně na URL a obslouží víc klientů. Pro vzdálené a sdílené servery; patří k němu autentizace (OAuth nebo token v hlavičce).

Starší transport HTTP+SSE je ve specifikaci nahrazen Streamable HTTP; u nových serverů ho nepoužívejte.

Vlastní MCP server v Pythonu

pip install "mcp[cli]"

# server.py
from mcp.server.fastmcp import FastMCP

mcp = FastMCP("demo")


@mcp.tool()
def add(a: int, b: int) -> int:
    """Sečte dvě celá čísla."""
    return a + b


@mcp.resource("note://{name}")
def note(name: str) -> str:
    """Vrátí poznámku podle názvu."""
    return f"Obsah poznámky {name}"


@mcp.prompt()
def review(code: str) -> str:
    """Zadání pro revizi kódu."""
    return f"Zkontroluj tento kód a vypiš chyby:\n\n{code}"


if __name__ == "__main__":
    mcp.run()  # výchozí transport: stdio

Typové anotace a docstring nejsou ozdoba: SDK z nich sestaví JSON schéma a popis nástroje, podle kterých se model rozhoduje, kdy a jak nástroj zavolat. Pro HTTP stačí mcp.run(transport="streamable-http").

Připojení ke klientovi

# Claude Code — lokální server přes stdio
claude mcp add demo -- python /abs/cesta/server.py

# Claude Code — vzdálený server přes HTTP
claude mcp add --transport http notes https://example.com/mcp

claude mcp list                 # připojené servery a jejich stav

Konfigurace sdílená s týmem patří do souboru .mcp.json v kořeni projektu:

{
  "mcpServers": {
    "demo": {
      "command": "python",
      "args": ["/abs/cesta/server.py"],
      "env": { "API_TOKEN": "${API_TOKEN}" }
    }
  }
}

Ladění

npx @modelcontextprotocol/inspector python server.py

MCP Inspector otevře webové rozhraní, kde jde vypsat nástroje, zdroje a prompty serveru a zavolat je ručně — bez modelu a bez klienta. Je to nejrychlejší způsob, jak zjistit, zda je chyba v serveru, nebo v konfiguraci klienta.

Přehled metod protokolu

Spojení vždy začíná initialize: obě strany si vymění verzi protokolu a capabilities — seznam toho, co která podporuje. Metodu, kterou druhá strana neohlásila, nevolejte.

Časté chyby