Setup Time: 15 Minutes

Setup Guide

Get your AI development environment up and running in just 15 minutes with our interactive setup wizard

🚀 Quick Start (Recommended)

The fastest way to get started with the synaptic

Clone Template

git clone https://github.com/johanlido/Synaptic.git

Download the synaptic to your local machine

Navigate to Directory

cd ai-mcp-template

Enter the template directory

Run Interactive Setup

./scripts/interactive-setup.sh

Start the guided setup wizard (macOS/Linux)

Windows Setup

.\scripts\setup.bat

Run setup script for Windows users

Use This Template

Platform-Specific Setup

📱

macOS

Requirements

  • macOS 10.15+ (Catalina or later)
  • Node.js 18+ (via Homebrew)
  • Python 3.8+ (built-in or via Homebrew)
  • Git (via Xcode Command Line Tools)
  • Claude Desktop app

Setup Steps

1
Install Homebrew: /bin/bash -c "$(curl -fsSL https://raw.githubusercontent.com/Homebrew/install/HEAD/install.sh)"
2
Install Node.js: brew install node
3
Install Python: brew install python
4
Install Git: xcode-select --install
5
Download Claude Desktop from claude.ai
🪟

Windows

Requirements

  • Windows 10/11
  • Node.js 18+ (from nodejs.org)
  • Python 3.8+ (from python.org)
  • Git (from git-scm.com)
  • Claude Desktop app

Setup Steps

1
Download and install Node.js from nodejs.org
2
Download and install Python from python.org
3
Download and install Git from git-scm.com
4
Download Claude Desktop from claude.ai
5
Enable PowerShell execution: Set-ExecutionPolicy RemoteSigned
🐧

Linux

Requirements

  • Ubuntu 20.04+ / Debian 10+ / CentOS 8+
  • Node.js 18+ (via package manager)
  • Python 3.8+ (usually pre-installed)
  • Git (via package manager)
  • Claude web interface (no desktop app)

Setup Steps

1
Update packages: sudo apt update && sudo apt upgrade
2
Install Node.js: curl -fsSL https://deb.nodesource.com/setup_18.x | sudo -E bash - && sudo apt-get install -y nodejs
3
Install Python: sudo apt install python3 python3-pip
4
Install Git: sudo apt install git
5
Use Claude web interface at claude.ai

Interactive Setup Process

1

Prerequisites Check

Validates Node.js, Python, Git, and Claude Desktop installation

2

Component Selection

Choose which MCP servers to install (Perplexity, Automation, Figma)

3

Configuration

Sets up environment variables and Claude Desktop integration

4

Health Check

Verifies installation and provides troubleshooting guidance

Need Help?

Common Issues

  • Permission denied: Grant Full Disk Access to Terminal (macOS)
  • Command not found: Ensure Node.js and Python are in PATH
  • MCP not detected: Restart Claude Desktop after configuration

Get Support

📖 Comprehensive Troubleshooting Guide🐛 Report Issues on GitHub💬 Community Discussions