Połącz z serwerem MCP Roblox Studio

Serwer MCP Roblox Studio jest wbudowany w Roblox Studio. Implementuje on Model Context Protocol (MCP), otwarty standard, który pozwala narzędziom AI bezpiecznie komunikować się z zewnętrznymi aplikacjami. Po nawiązaniu połączenia, twój klient AI może bezpośrednio interagować z otwartą sesją Studio, eksplorując model danych, pisząc skrypty, uruchamiając kod Luau oraz testując swoje doświadczenia w trybie gry.

Ten przewodnik pokazuje, jak połączyć serwer MCP Studio z popularnymi klientami AI. Choć konfiguracja różni się w zależności od klienta, zasadnicza idea pozostaje ta sama: konfigurujesz swojego klienta, aby połączył się z serwerem MCP, a następnie wysyłasz polecenia z klienta do aktywnej sesji Studio.

Wymagania wstępne

Przed nawiązaniem połączenia z serwerem upewnij się, że masz zainstalowaną najnowocześniejszą wersję Roblox Studio oraz preferowanego klienta MCP na swoim komputerze.

Jak działa serwer MCP Studio

Serwer działa jako lokalny proces na twojej maszynie i komunikuje się z klientem AI za pomocą transmisji stdio, która wykorzystuje standardowe strumienie wejścia/wyjścia. Wszystkie akcje są inicjowane przez twojego klienta AI, który następnie wysyła żądanie przez ten kanał, aby wykonać akcje wewnątrz sesji Studio.

Serwer udostępnia następujące narzędzia:

Włącz serwer MCP w Studio

Aby włączyć serwer MCP w Studio:

1. Otwórz Asystenta.
2. Kliknij … ⟩ Zarządzaj serwerami MCP.
3. Włącz Włącz Studio jako serwer MCP.

Po włączeniu, panel ustawień wyświetla opcję szybkiego połączenia i instrukcje instalacji dla różnych klientów. Gdy klient pomyślnie się połączy, zielony wskaźnik pokazuje liczbę podłączonych klientów.

Połącz swojego klienta

Możesz połączyć swojego klienta z serwerem MCP Studio, korzystając z szybkiego połączenia, konfiguracji JSON lub polecenia CLI.

• Użyj szybkiego połączenia, jeśli twój klient jest obsługiwany.
• Jeśli nie, użyj konfiguracji JSON, jeśli twój klient obsługuje pliki konfiguracyjne MCP.
• W przeciwnym razie użyj polecenia CLI.

Serwer MCP Studio współpracuje z każdym klientem, który obsługuje transmisję stdio. Po dodaniu konfiguracji, postępuj zgodnie z dokumentacją swojego klienta, aby ukończyć konfigurację, a następnie zrestartuj klienta, aby zastosować zmiany.

Szybkie połączenie

Szybkie połączenie obsługuje następujące klientów:

• Antigravity
• Codex CLI
• Claude Code
• Claude Desktop
• Cursor
• Gemini CLI
• Visual Studio Code

Aby połączyć się za pomocą szybkiego połączenia:

1. Przejdź do Ustawienia Asystenta ⟩ Serwery MCP.
2. Rozwiń rozwijane menu Szybkie połączenie, aby zobaczyć obsługiwanych klientów zainstalowanych na twoim komputerze.
3. Włącz wybranego klienta.

Jeśli klient, którego chcesz, nie pojawia się na liście Szybkie połączenie, zainstaluj go i zrestartuj Roblox Studio.

Konfiguracja JSON

Większość klientów MCP obsługuje pliki konfiguracyjne JSON. Poniższe przykłady pokazują pełne konfiguracje, które możesz wykorzystać.

Jeśli Roblox Studio jest twoim jedynym serwerem MCP, użyj tych konfiguracji bez zmian. Jeśli używasz wielu serwerów MCP, skopiuj wpis Roblox_Studio i dodaj go do istniejącego słownika mcpServers.

Konfiguracje różnią się w zależności od systemu operacyjnego:

Windows
{
  "mcpServers": {
    "Roblox_Studio": {
      "command": "cmd.exe",
      "args": [
        "/c",
        "%LOCALAPPDATA%\\Roblox\\mcp.bat"
      ]
    }
  }
}

macOS
{
  "mcpServers": {
    "Roblox_Studio": {
      "command": "/Applications/RobloxStudio.app/Contents/MacOS/StudioMCP"
    }
  }
}

Polecenie CLI

Niektórzy klienci MCP wymagają polecenia CLI zamiast konfiguracji JSON. Użyj odpowiedniego polecenia dla swojego systemu operacyjnego:

Windows
cmd.exe /c %LOCALAPPDATA%\Roblox\mcp.bat

macOS
/Applications/RobloxStudio.app/Contents/MacOS/StudioMCP

Użyj wielu instancji Studio

Możesz połączyć jeden klienta MCP z wieloma uruchomionymi instancjami Studio w tym samym czasie. Serwer automatycznie określa, którą instancję wykorzystać na podstawie kontekstu (na przykład, jeśli odnosisz się do konkretnego doświadczenia lub obiektu, który istnieje tylko w tej instancji).

Możesz ręcznie przełączać instancje za pomocą list_roblox_studios i set_active_studio.

Zweryfikuj swoje połączenie

Po skonfigurowaniu swojego klienta, zweryfikuj, czy połączenie działa w Roblox Studio:

1. Otwórz Asystenta.
2. Kliknij … ⟩ Zarządzaj serwerami MCP.
3. W sekcji Włącz Studio jako serwer MCP sprawdź zielony wskaźnik, aby potwierdzić, że klient pomyślnie się połączył.

Rozwiązywanie problemów

Jeśli serwer się nie wyświetla lub narzędzia są niedostępne:

• Zrestartuj zarówno Roblox Studio, jak i swojego klienta MCP.
• Zweryfikuj, że ścieżka do polecenia lub pliku binarnego jest prawidłowa i plik istnieje.
• Sprawdź składnię JSON. Nawet brak przecinka lub nawiasu może uniemożliwić załadowanie konfiguracji.