Lewati ke konten
MarkasUI
Ketik untuk mencari

    Panduan

    MarkasUI

    Form

    Feedback

    Overlay

    Navigasi

    Data

    Section

    Animasi

    Latar

    Tombol

    Template

    Halaman

    MCP

    Pasang MCP server MarkasUI di Claude Code, Codex, JenderalCode, Cursor, VS Code, Gemini CLI, Antigravity, dan agent coding AI lainnya.

    Paket @markasui/mcp adalah MCP server lokal yang berjalan lewat stdio. Agent AI memakainya untuk mencari komponen, mengambil kode untuk framework yang tepat, dan membaca langkah instalasi. Data diambil dari registry /r/ dan di-cache di memori selama proses berjalan.

    Semua harness menjalankannya dengan cara yang sama: npx -y @markasui/mcp. Anda butuh Node.js 20 atau lebih baru. Yang berbeda hanya tempat perintah itu ditulis, dan halaman ini mencantumkannya untuk setiap tool.

    Pasang cepat

    Agent yang punya perintah mcp add:

    # Claude Code
    claude mcp add markasui -- npx -y @markasui/mcp
    
    # OpenAI Codex (CLI, ekstensi IDE, dan aplikasi memakai konfigurasi yang sama)
    codex mcp add markasui -- npx -y @markasui/mcp
    
    # Gemini CLI (flag untuk npx ditulis setelah --)
    gemini mcp add markasui npx -- -y @markasui/mcp
    
    # OpenCode
    opencode mcp add markasui -- npx -y @markasui/mcp
    
    # Amp
    amp mcp add markasui -- npx -y @markasui/mcp

    Sebagian besar tool lain membaca file JSON berisi objek mcpServers. Isinya sama di mana pun, hanya path file-nya yang berbeda:

    {
      "mcpServers": {
        "markasui": {
          "command": "npx",
          "args": ["-y", "@markasui/mcp"]
        }
      }
    }

    Claude Code

    claude mcp add markasui -- npx -y @markasui/mcp

    Perintah ini menyimpan server untuk Anda sendiri di project saat ini. Tambahkan --scope user supaya tersedia di semua project, atau --scope project supaya ditulis ke .mcp.json di root project dan tim Anda mendapatkannya lewat git. File .mcp.json juga bisa ditulis manual:

    {
      "mcpServers": {
        "markasui": {
          "command": "npx",
          "args": ["-y", "@markasui/mcp"]
        }
      }
    }

    Cek: jalankan claude mcp get markasui, atau ketik /mcp di sesi dan pastikan markasui berstatus terhubung.

    OpenAI Codex

    codex mcp add markasui -- npx -y @markasui/mcp

    Perintah ini menulis ke ~/.codex/config.toml. Untuk mengeditnya sendiri, tambahkan tabel berikut (atau di .codex/config.toml supaya hanya berlaku untuk satu project):

    [mcp_servers.markasui]
    command = "npx"
    args = ["-y", "@markasui/mcp"]

    Codex CLI, ekstensi IDE, dan aplikasi desktop ChatGPT membaca file yang sama, jadi satu kali pasang sudah berlaku untuk ketiganya.

    Cek: jalankan codex mcp list, atau ketik /mcp di TUI Codex.

    JenderalCode

    JenderalCode membaca .mcp.json project yang sama dengan Claude Code. Commit file ini di root project:

    {
      "mcpServers": {
        "markasui": {
          "command": "npx",
          "args": ["-y", "@markasui/mcp"]
        }
      }
    }

    .mcp.json sebuah project baru dijalankan setelah Anda memercayai file itu persis: buka bagian MCP di Settings lalu pilih Trust and run. Mengedit file tersebut mencabut kepercayaan itu, jadi JenderalCode akan bertanya lagi.

    Supaya MarkasUI tersedia di semua project, tambahkan server lewat pengaturan MCP. Server disimpan ke ~/.config/jenderalcode/mcp.json dengan format yang sama. JenderalCode juga membaca Agent Skill dari .claude/skills dan ~/.claude/skills.

    Cek: server tampil berjalan di pengaturan MCP beserta daftar tool-nya.

    Claude Desktop

    Buka Settings, lalu Developer, lalu Edit Config. Ini membuka claude_desktop_config.json:

    • macOS: ~/Library/Application Support/Claude/claude_desktop_config.json
    • Windows: %APPDATA%\Claude\claude_desktop_config.json
    • Linux: ~/.config/Claude/claude_desktop_config.json
    {
      "mcpServers": {
        "markasui": {
          "command": "npx",
          "args": ["-y", "@markasui/mcp"]
        }
      }
    }

    Tutup Claude Desktop sepenuhnya lalu buka lagi. Cek: buka menu konektor di kolom chat dan cari markasui. Log ada di ~/Library/Logs/Claude (macOS) atau %APPDATA%\Claude\logs (Windows).

    Cursor

    Tambahkan MarkasUI ke Cursor dengan sekali klik, atau tambahkan ke .cursor/mcp.json di project (~/.cursor/mcp.json untuk semua project):

    {
      "mcpServers": {
        "markasui": {
          "type": "stdio",
          "command": "npx",
          "args": ["-y", "@markasui/mcp"]
        }
      }
    }

    Cek: server muncul di pengaturan MCP Cursor. Kalau gagal, buka panel Output lalu pilih MCP Logs.

    VS Code dan GitHub Copilot

    Tambahkan .mcp.json di root workspace supaya server bisa dipakai bersama tim:

    {
      "mcpServers": {
        "markasui": {
          "type": "stdio",
          "command": "npx",
          "args": ["-y", "@markasui/mcp"],
          "tools": ["*"]
        }
      }
    }

    Untuk semua workspace, tulis isi yang sama di ~/.copilot/mcp-config.json, yang juga dibaca Copilot CLI.

    Anda juga bisa memasangnya di VS Code dengan sekali klik, atau dari terminal. Keduanya menambahkan server ke profil pengguna VS Code:

    code --add-mcp '{"name":"markasui","type":"stdio","command":"npx","args":["-y","@markasui/mcp"]}'

    Setup lama memakai .vscode/mcp.json dengan kunci servers, bukan mcpServers. VS Code masih membacanya, tetapi konfigurasi Copilot baru sebaiknya memakai file di atas.

    Cek: jalankan MCP: List Servers dari Command Palette.

    Gemini CLI

    gemini mcp add markasui npx -- -y @markasui/mcp

    Perintah ini menulis ke .gemini/settings.json di project. Tambahkan --scope user untuk menulis ke ~/.gemini/settings.json. Isinya di kedua file:

    {
      "mcpServers": {
        "markasui": {
          "command": "npx",
          "args": ["-y", "@markasui/mcp"]
        }
      }
    }

    Cek: jalankan gemini mcp list, atau ketik /mcp di sesi.

    Google Antigravity

    Di panel agent, buka menu …, pilih MCP Servers, lalu Manage MCP Servers, lalu View raw config. Tempel isi berikut ke mcp_config.json:

    {
      "mcpServers": {
        "markasui": {
          "command": "npx",
          "args": ["-y", "@markasui/mcp"]
        }
      }
    }

    File global ada di ~/.gemini/config/mcp_config.json. Untuk satu project, pakai .agents/mcp_config.json di workspace.

    Cek: ketik /mcp di panel prompt untuk melihat status server.

    Devin Desktop (Windsurf)

    Windsurf sekarang bernama Devin Desktop, dan konfigurasi MCP-nya sama dengan Devin CLI:

    devin mcp add markasui -- npx -y @markasui/mcp

    Atau edit file-nya manual: .devin/mcp_config.json di project, atau ~/.config/devin/mcp_config.json (%APPDATA%\devin\mcp_config.json di Windows) untuk semua project. Pakai isi mcpServers dari Pasang cepat.

    Cek: jalankan devin mcp list, atau buka Customize di jendela Agents lalu klik MCPs.

    Zed

    Tambahkan ke settings.json Zed:

    {
      "context_servers": {
        "markasui": {
          "command": "npx",
          "args": ["-y", "@markasui/mcp"],
          "env": {}
        }
      }
    }

    Cek: di Settings, AI, MCP Servers, titik hijau di samping markasui berarti server aktif.

    JetBrains AI Assistant dan Junie

    AI Assistant: buka Settings, Tools, AI Assistant, Model Context Protocol (MCP), klik Add, lalu tempel JSON mcpServers dari Pasang cepat. Klik Apply lalu lihat kolom Status.

    Junie: tulis JSON yang sama di .junie/mcp/mcp.json di root project, atau di ~/.junie/mcp/mcp.json untuk semua project. Server yang ditambahkan dari Tools, Junie, MCP Settings disimpan ke file global. Cek dengan /mcp di Junie CLI.

    Cline

    Klik ikon MCP Servers di toolbar Cline, buka tab Configure, lalu klik Configure MCP Servers. Ini membuka cline_mcp_settings.json:

    {
      "mcpServers": {
        "markasui": {
          "command": "npx",
          "args": ["-y", "@markasui/mcp"],
          "disabled": false
        }
      }
    }

    Cek: tool server muncul di panel MCP Servers.

    Roo Code

    Tambahkan ke .roo/mcp.json di root project, atau buka mcp_settings.json global lewat Edit Global MCP di bagian bawah pengaturan Roo Code:

    {
      "mcpServers": {
        "markasui": {
          "command": "npx",
          "args": ["-y", "@markasui/mcp"]
        }
      }
    }

    File project yang dipakai kalau keduanya mendefinisikan markasui. Cek: server tampil aktif di daftar MCP servers.

    Kiro

    Tambahkan ke .kiro/settings/mcp.json di workspace, atau ~/.kiro/settings/mcp.json untuk semua workspace. Command palette punya Kiro: Open workspace MCP config (JSON) untuk ini.

    {
      "mcpServers": {
        "markasui": {
          "command": "npx",
          "args": ["-y", "@markasui/mcp"],
          "disabled": false
        }
      }
    }

    Kiro langsung menerapkan perubahan saat file disimpan.

    OpenCode

    opencode mcp add markasui -- npx -y @markasui/mcp

    Atau tambahkan ke opencode.jsonc di project (~/.config/opencode/opencode.json untuk semua project). OpenCode punya format sendiri, dengan perintah ditulis sebagai satu array:

    {
      "mcp": {
        "servers": {
          "markasui": {
            "type": "local",
            "command": ["npx", "-y", "@markasui/mcp"]
          }
        }
      }
    }

    Cek: opencode mcp list menampilkan markasui berstatus terhubung.

    Continue

    Buat .continue/mcpServers/markasui.yaml di workspace:

    name: MarkasUI
    version: 0.0.1
    schema: v1
    mcpServers:
      - name: markasui
        type: stdio
        command: npx
        args: ["-y", "@markasui/mcp"]

    Continue juga menerima file JSON di folder itu dengan format mcpServers dari Pasang cepat. Tool MCP hanya bisa dipakai di mode agent.

    Warp

    Buka Settings, Agents, MCP servers (atau cari Open MCP Servers di Command Palette), klik + Add, lalu tempel JSON mcpServers dari Pasang cepat.

    Cek: markasui tampil sedang berjalan dan tool-nya terlihat.

    Amp

    amp mcp add markasui -- npx -y @markasui/mcp

    Atau tambahkan di bawah amp.mcpServers di ~/.config/amp/settings.json (.amp/settings.json untuk satu workspace):

    {
      "amp.mcpServers": {
        "markasui": {
          "command": "npx",
          "args": ["-y", "@markasui/mcp"]
        }
      }
    }

    Cek: jalankan amp mcp doctor.

    Goose

    Jalankan goose configure, pilih Add Extension, lalu Command-line Extension. Beri nama markasui dan isi perintah npx -y @markasui/mcp. Hasilnya di ~/.config/goose/config.yaml:

    extensions:
      markasui:
        name: markasui
        type: stdio
        cmd: npx
        args: ["-y", "@markasui/mcp"]
        enabled: true
        timeout: 300

    GitHub Copilot cloud agent

    Agent yang mengerjakan issue dan pull request di GitHub membaca server dari pengaturan repository. Buka Settings, lalu Copilot, lalu MCP servers, tempel isi berikut, lalu klik Save MCP configuration:

    {
      "mcpServers": {
        "markasui": {
          "type": "local",
          "command": "npx",
          "args": ["-y", "@markasui/mcp"],
          "tools": [
            "list_components",
            "search_components",
            "get_component",
            "get_theme",
            "get_setup"
          ]
        }
      }
    }

    Copilot menjalankan tool ini tanpa bertanya, dan kelimanya hanya membaca registry. Kalau log sesi menampilkan peringatan firewall, tambahkan markas.jenderalcorp.com ke allowlist firewall agent.

    Cek: assign sebuah issue ke Copilot, buka View session, lalu buka langkah Start MCP Servers. Daftar tool ada di bagian bawah.

    Tool yang tersedia

    ToolInputOutput
    list_componentscategory?Nama, judul, kategori, deskripsi semua komponen
    search_componentsqueryKomponen yang cocok berdasarkan nama, deskripsi, dan tag
    get_componentname, frameworkKode, props, dependensi, aturan AI, contoh pemakaian, target path
    get_themetidak adaIsi markas.css dan daftar token
    get_setupframeworkLangkah instalasi Tailwind dan markas.css

    framework berisi salah satu dari blade, react, vue, svelte, astro, atau angular.

    Registry lain

    Set variabel MARKASUI_REGISTRY di konfigurasi MCP untuk memakai mirror atau folder lokal. Nilainya adalah folder yang berisi index.json: URL https:// atau path lokal. Bawaannya https://markas.jenderalcorp.com/r.

    claude mcp add markasui --env MARKASUI_REGISTRY=https://mirror.example.com/r -- npx -y @markasui/mcp

    Di konfigurasi JSON, tambahkan objek env di samping args:

    {
      "mcpServers": {
        "markasui": {
          "command": "npx",
          "args": ["-y", "@markasui/mcp"],
          "env": { "MARKASUI_REGISTRY": "https://mirror.example.com/r" }
        }
      }
    }

    Di Codex, tambahkan env = { MARKASUI_REGISTRY = "https://mirror.example.com/r" } ke tabel [mcp_servers.markasui]. OpenCode menamai objek ini environment, sedangkan Goose menamainya envs.

    Windows

    Sebagian besar harness bisa menjalankan npx di Windows tanpa perubahan. Kalau server tidak pernah terhubung, atau log menampilkan spawn npx ENOENT, jalankan lewat cmd /c:

    {
      "mcpServers": {
        "markasui": {
          "command": "cmd",
          "args": ["/c", "npx", "-y", "@markasui/mcp"]
        }
      }
    }

    Untuk perintah mcp add, tulis cmd /c sebelum npx:

    claude mcp add markasui -- cmd /c npx -y @markasui/mcp

    Pemecahan masalah

    • Versi Node. Jalankan node --version dan pasang Node.js 20 atau lebih baru kalau versinya lebih lama. Aplikasi desktop di macOS kadang tidak melihat Node yang dipasang lewat nvm atau fnm. Pakai path lengkap dari which npx sebagai command.
    • Versi lama dari cache npx. npx memakai ulang salinan yang sudah diunduh sebelumnya. Pakai @markasui/mcp@latest di args untuk mendapat rilis terbaru, atau hapus folder _npx di dalam folder yang dicetak npm config get cache.
    • Proxy kantor. npx mengunduh lewat npm, jadi set npm config set https-proxy http://proxy.example.com:8080. Setelah itu server mengambil registry dengan fetch bawaan Node: di Node 22.21 atau 24 ke atas, tambahkan HTTPS_PROXY dan NODE_USE_ENV_PROXY=1 ke env server. Kalau proxy memakai sertifikat sendiri, tambahkan NODE_EXTRA_CA_CERTS berisi path sertifikat tersebut. Kalau registry diblokir sama sekali, arahkan MARKASUI_REGISTRY ke mirror atau salinan lokal.
    • Error registry. Cannot reach the registry berarti URL tidak bisa dijangkau dari mesin tempat agent berjalan. Not found in the registry berarti MARKASUI_REGISTRY tidak menunjuk ke folder yang berisi index.json.
    • Uji di terminal. Jalankan npx -y @markasui/mcp. Server yang berfungsi tidak mencetak apa pun dan menunggu input, karena klien MCP berkomunikasi lewat stdin. Tekan Ctrl+C untuk berhenti. Error yang muncul di sini sama dengan yang dialami harness Anda.

    Contoh prompt

    Buat halaman login Laravel memakai komponen MarkasUI: input email, input kata sandi, dan tombol masuk.

    Agent akan memanggil get_setup, lalu get_component untuk input dan button, dan menyimpan file di folder yang benar.