Setup — SPEC4AI

SETUP

Get started with SPEC4AI Studio

Download SPEC4AI Link for your desktop, install the app on your phone, and connect them in minutes.

What you need

SPEC4AI Studio (Android)

Available on Google Play (coming soon). Runs applets, on-device AI, and the MCP server.

SPEC4AI Link (Desktop)

Menu bar app (macOS) or Traffic Manager bridge (Linux/Windows). Connects Claude Desktop to your phone.

DOWNLOAD

Download SPEC4AI Link

macOS

Universal binary — Intel & Apple Silicon

Download DMG (8.0 MB)

Open DMG → Drag to Applications → Launch from menu bar

Gatekeeper notice

macOS may show "SPEC4AI Link cannot be opened" because the app is not notarized. To allow it, right-click the app in Finder and choose Open, or run in Terminal:

xattr -cr "/Applications/SPEC4AI Link.app"

Linux

Ubuntu/Debian (.deb) or Fedora/RHEL (.rpm)

.deb x64 (3.1 MB).deb ARM (2.9 MB).rpm x64 (3.2 MB).rpm ARM (2.9 MB)

sudo dpkg -i spec4ai-link-tm_1.0.2_amd64.deb

sudo rpm -i spec4ai-link-tm-1.0.2-1.x86_64.rpm

Includes systemd user service. Enable with: systemctl --user enable --now spec4ai-link-tm

Windows

x64 installer with Add/Remove Programs support

Download Installer (3.2 MB)

Run the installer → Installs to Program Files → Configures Claude Desktop automatically

SETUP GUIDE

Connect in 3 steps

Install SPEC4AI Studio on your phone

Download SPEC4AI Studio from Google Play (coming soon) or sideload the APK. The app runs applets, on-device AI, and the MCP server.

Install SPEC4AI Link on your desktop

Download the macOS DMG, Linux package, or Windows installer from the download section above. SPEC4AI Link connects Claude Desktop to your phone.

Pair your devices

Open SPEC4AI Studio on your phone, go to Settings, and tap "Show pairing PIN." Enter the 6-digit PIN in SPEC4AI Link on your Mac. For Linux/Windows, run spec4ai-link-tm and use adb forward tcp:8436 tcp:8435 for USB, or connect via the phone's IP on the same network.

Configure Claude Desktop

Add the following to your Claude Desktop configuration file:

{
  "mcpServers": {
    "spec4ai": {
      "command": "spec4ai-link-tm",
      "env": {
        "SPEC4AI_URL": "http://127.0.0.1:8436",
        "SPEC4AI_AGENT": "claude-cli"
      }
    }
  }
}

macOS~/Library/Application Support/Claude/claude_desktop_config.json

Linux~/.config/Claude/claude_desktop_config.json

Windows%APPDATA%\Claude\claude_desktop_config.json

macOS DMG configures Claude Desktop automatically. You only need to edit the config file manually on Linux and Windows.

Ready to try?

Explore the documentation to learn what you can build, or jump straight into the feature overview.

Getting started guide Feature overview