Server Minecraft MCP

Accesează servere Minecraft, skin-uri și funcțiile contului din instrumentele AI pe care le folosești deja.

Vizitator: doar citirePersonal: permisiunile taleStreamable HTTP

Codex · Claude · Cursor · VS Code · ChatGPT · Hermes · OpenClaw

Model Context Protocol

Date Minecraft direct în conversația cu AI

Minecraft.How MCP conectează asistenții AI la catalogul nostru de servere și skin-uri prin Model Context Protocol. Caută listări publice fără cont sau folosește tokenul tău pentru datele contului și operațiile de administrare disponibile. Agentul primește rezultate structurate și linkuri către surse.

Găsește un server

Compară servere Java, Bedrock și crossplay după nume, categorie sau versiune. Vezi adresele și ultimele valori salvate pentru numărul de jucători.

Găsește un skin Minecraft

Caută skin-uri publice după nume și obține linkurile paginilor și imaginilor, fără să părăsești conversația.

Conectează propriul agent

Folosește Codex, Claude Code, Hermes Agent sau OpenClaw cu tokenul tău. Datele și acțiunile disponibile respectă permisiunile contului.

Cum te conectezi

Alege tipul de acces și clientul. Copiază configurația, activează serverul și încearcă primul prompt.

Nu ai nevoie de cont sau cheie API. Doar servere și skin-uri publice. Limita este de 30 de cereri pe minut pentru fiecare IP și 20 de rezultate per căutare.

Adresa serverului

https://minecraft.how/api/mcp

Codex / Configurare

1Deschide fișierul de configurare Codex și adaugă blocul de mai jos.
2Pentru acces personal, setează MINECRAFT_HOW_TOKEN în mediul din care pornești Codex.
3Pornește o sesiune Codex nouă și folosește /mcp pentru a verifica serverul și tool-urile.

Documentația oficială a clientului

~/.codex/config.toml

[mcp_servers.minecraft-how]
url = "https://minecraft.how/api/mcp"

Execută primul apel

Trimite acest prompt în AI-ul conectat și verifică dacă apelează un tool Minecraft.How, în loc să răspundă din memorie.

Execută primul apel

Folosește Minecraft.How MCP pentru a găsi 5 servere Java survival. Include linkurile sursă și data ultimei verificări a stării, dacă este disponibilă.

Idei pentru următoarea conversație

Folosește aceste prompturi în ChatGPT, Claude, Codex sau alt client MCP conectat.

01 · Vizitator · doar citire

Găsește 5 servere Bedrock pe Minecraft.How și include adresa și linkul sursă pentru fiecare.

02 · Vizitator · doar citire

Caută pe Minecraft.How skin-uri numite knight. Arată 5 variante cu linkuri către imagini.

03 · Vizitator · doar citire

Obține detaliile primului server din rezultate. Starea salvată este online sau offline?

04 · Token personal

Arată ce resurse Minecraft.How poate citi tokenul meu personal și ce acțiuni poate executa.

Tool-uri Minecraft MCP

Conexiunea pentru vizitatori oferă aceste patru tool-uri doar pentru citire. Conexiunile personale adaugă tool-uri de cont, cu autorizare la fiecare apel.

search_servers

Caută listări publice după nume, adresă, ediție, categorie sau versiune Minecraft acceptată.

Parametri: query, platform, category, version, limit

get_server_details

Vezi adresa, starea salvată și linkul sursă al unui server găsit prin căutare.

Parametri: server_id

search_skins

Caută skin-uri Minecraft publice după nume, ordonate după descărcări.

Parametri: query, limit

get_skin_details

Obține detaliile unui skin vizibil, linkul paginii și linkul imaginii.

Parametri: skin_id

Tool-uri pentru agentul personal

get_project_capabilities listează resursele și acțiunile disponibile. read_project_data returnează înregistrările permise, cu paginare. manage_project_record folosește validarea și controllerele existente ale site-ului pentru modificările acceptate.

Pentru blog poți folosi și get_blog_posts, get_content_opportunities și get_minecraft_versions. Oportunitățile interne necesită permisiunea agents.blog.view. Aceste tool-uri nu sunt disponibile vizitatorilor.

Acces și permisiuni

Căutare publică

30 de cereri/minut per IP. Cel mult 20 de rezultate per căutare. Skin-urile ascunse, serverele private și datele de cont sunt excluse.

Contul tău, drepturile tale

120 de cereri/minut per utilizator. Cel mult 50 de înregistrări per cerere de cont. Scopurile tokenului restrâng accesul; permisiunile Spatie stabilesc operațiile permise. Resursele personale respectă regulile de proprietate.

Control din Acces API

Creează câte un token pentru fiecare agent, setează o dată de expirare și revocă-l oricând. Retragerea unei permisiuni utilizatorului o retrage și conexiunii MCP.

Execută un apel API direct

Pentru dezvoltatori: listează tool-urile MCP publice cu o cerere JSON-RPC POST. Clienții MCP gestionează automat inițializarea protocolului; acest endpoint fără sesiune acceptă și apelul direct de mai jos.

JSON-RPC · curl

curl --fail-with-body 'https://minecraft.how/api/mcp' \
  -H 'Content-Type: application/json' \
  -H 'Accept: application/json, text/event-stream' \
  -H 'MCP-Protocol-Version: 2025-11-25' \
  --data '{"jsonrpc":"2.0","id":1,"method":"tools/list","params":{}}'

Întrebări despre conectare

Poate AI-ul să joace Minecraft sau să ruleze comenzi pe serverul meu?

Nu. Acest server MCP oferă date din catalogul Minecraft.How și acțiuni permise pe site. Nu intră într-o lume Minecraft, nu accesează fișierele jocului și nu oferă shell sau RCON.

De ce apare 405 când deschid endpoint-ul în browser?

Endpoint-ul acceptă cereri MCP prin HTTP POST. Bara de adrese trimite GET, care primește 405 Method Not Allowed. Testează cu un client MCP sau cu exemplul API de mai sus.

De ce nu poate agentul vedea o înregistrare sau executa o acțiune?

Verifică endpoint-ul, scopurile și expirarea tokenului, precum și permisiunile contului. Tokenul nu acordă permisiuni Spatie suplimentare. Începe cu get_project_capabilities pentru a vedea accesul disponibil.

Numărul de jucători este în timp real?

Valorile provin din ultima verificare salvată, nu dintr-un ping nou declanșat de prompt. Verifică last_ping când compari rezultatele. Pentru serverele offline, numărul vechi de jucători este omis.

Pot folosi alt client decât cei listați?

Da, dacă acceptă MCP la distanță prin Streamable HTTP. Pentru acces personal trebuie să accepte și un token Bearer în antetul Authorization. Formatul configurației diferă între clienți.

Ce fac dacă primesc 401, 403 sau 429?

401 indică un token lipsă, expirat, revocat sau fără mcp:read. 403 indică lipsa accesului la resursa sau acțiunea cerută. La 429, așteaptă intervalul Retry-After înainte să reîncerci.

Ghiduri verificate: 19 octombrie 2026