Installation & Setup

This section walks you through getting started with ContextMesh via our hosted Web or the Local CLI.


1. Web App Sign-in

  1. Visit the Portal Go to https://contextmesh.io

  2. Connect Your Phantom Wallet

    • Click Connect Wallet in the top-right

    • Select Phantom and approve the connection in your wallet extension

    • No email or password required

  3. Create Your First Workspace

    • Click New Workspace

    • Give it a name (e.g. My First MCP)

    • Optionally connect your GitHub or GitLab account for manifest imports

  4. Import or Start a Manifest

    • In your workspace dashboard, click Import Manifest to upload an existing manifest.json

    • Or click Create New to launch the drag-&-drop manifest editor

  5. Explore & Publish

    • Customize your building blocks in the web IDE

    • When ready, click Publish → Export Manifest to download or share


2. Local CLI (mcp run) Installation

2.1 Prerequisites

  • Node.js ≥ 14.x

  • npm (or yarn)

  • Git ≥ 2.x

  • Phantom Wallet browser extension

2.2 Install the CLI

# Using npm
npm install --global @contextmesh/cli

# Or using yarn
yarn global add @contextmesh/cli

2.3 Authenticate via Wallet

# Point the CLI at your ContextMesh endpoint
export CONTEXTMESH_ENDPOINT=https://contextmesh.io
  1. Run mcp login

  2. Follow the prompt to open your browser

  3. Click Connect Wallet and approve in Phantom

  4. Return to the CLI—your session is now authenticated

2.4 Run a Manifest

# Navigate to your project folder containing manifest.json
cd /path/to/your/project

# Start your MCP locally
mcp run

This command will:

  1. Validate your manifest.json

  2. Spin up a local development server

  3. Watch for changes and hot-reload your blocks

You’re now ready to build, test, and iterate on your MCP manifests locally! 🎉

Last updated