Połącz się z serwerem MCP Roblox Studio

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

Ten przewodnik pokazuje, jak połączyć serwer MCP Studio z popularnymi klientami AI. Chociaż konfiguracja różni się w zależności od klienta, podstawowa idea jest taka 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

Zanim będziesz mógł połączyć się z serwerem, upewnij się, że masz najnowższą wersję Roblox Studio oraz zainstalowanego preferowanego klienta MCP na swoim komputerze.

Jak działa serwer MCP Studio

Serwer działa jako lokalny proces na twoim komputerze i komunikuje się z klientem AI za pomocą transportu stdio, który wykorzystuje standardowe strumienie wejścia/wyjścia. Wszystkie akcje są inicjowane przez twój klient AI, który następnie wysyła żądanie przez ten kanał, aby wykonać akcje w twojej sesji Studio.

Serwer zapewnia 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 konfiguracji dla różnych klientów. Gdy klient połączy się pomyślnie, zielony wskaźnik pokazuje liczbę połączonych klientów.

Połącz swój klient

Możesz połączyć swojego klienta z serwerem MCP Studio, używając 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 działa z każdym klientem, który obsługuje transport stdio. Po dodaniu konfiguracji, postępuj zgodnie z dokumentacją swojego klienta, aby zakończyć konfigurację, a następnie uruchom ponownie klienta, aby zastosować zmiany.

Szybkie połączenie

Szybkie połączenie obsługuje następujących 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 uruchom ponownie 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 użyć.

Jeśli Roblox Studio jest jedynym twoim 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:

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

{
  "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:

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

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

Użyj wielu instancji Studio

Możesz połączyć pojedynczego klienta MCP z wieloma uruchomionymi instancjami Studio jednocześnie. Serwer automatycznie określa, którą instancję użyć na podstawie kontekstu (na przykład, jeśli odwołujesz się do konkretnej gry lub obiektu, który istnieje tylko w tej instancji).

Możesz ręcznie przełączać instancje, używając list_roblox_studios i set_active_studio.

Zweryfikuj swoje połączenie

Po skonfigurowaniu klienta, zweryfikuj, że 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 połączył się pomyślnie.

Rozwiązywanie problemów

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

• Uruchom ponownie zarówno Roblox Studio, jak i swojego klienta MCP.
• Sprawdź, czy ścieżka do polecenia lub binarnego pliku jest poprawna i czy plik istnieje.
• Sprawdź składnię JSON. Nawet brakujący przecinek lub nawias może uniemożliwić załadowanie konfiguracji.