> ## Documentation Index
> Fetch the complete documentation index at: https://docs.weavemcp.com/llms.txt
> Use this file to discover all available pages before exploring further.

# Quickstart

> Get your first MCP server connected and making requests in 5 minutes

# WeaveMCP Quickstart Guide

Get your first MCP server connected and making requests in 5 minutes.

## What is MCP?

The **Model Context Protocol (MCP)** enables AI assistants like Claude to securely connect to external tools and data sources. WeaveMCP acts as a secure proxy layer, letting you centrally manage and share MCP servers across your organization.

Instead of each developer maintaining their own MCP server configurations, WeaveMCP provides:

* **Virtual MCP Servers**: Centralized endpoints that proxy to your actual MCP servers
* **Team Access Control**: Share servers across your organization with proper permissions
* **Unified Management**: One place to configure all your MCP integrations

## Step 1: Authentication

Choose your preferred method to get started with WeaveMCP:

<Tabs>
  <Tab title="Web Console">
    ### Web Console

    1. Go to [console.weavemcp.com](https://console.weavemcp.com)
    2. Click **Sign in with GitHub** or **Sign in with Google**
    3. Authorize WeaveMCP to access your account
  </Tab>

  <Tab title="CLI Commands">
    ### CLI Authentication

    First, install the WeaveMCP agent:

    ```bash theme={null}
    curl -fsSL https://console.weavemcp.com/install.sh | bash
    ```

    Then authenticate:

    ```bash theme={null}
    weave login
    ```

    This will open your browser to complete the authentication flow.
  </Tab>
</Tabs>

## Step 2: Organization Setup

<Tabs>
  <Tab title="Web Console">
    ### Create or Join Organization

    After signing in, you'll be prompted to either:

    * **Create a new organization** (if you're setting up WeaveMCP for your team)
    * **Join an existing organization** (if a teammate has already set up WeaveMCP)

    For this quickstart, create a new organization called "My Company".
  </Tab>

  <Tab title="CLI Commands">
    ### Organization Setup

    After authentication, check your status:

    ```bash theme={null}
    weave status
    ```

    If you don't have an organization, you'll be prompted to create one during the web authentication flow.
  </Tab>
</Tabs>

## Step 3: Create Your First Virtual MCP Server

<Tabs>
  <Tab title="Web Console">
    ### Web Console Steps

    1. From your organization dashboard, click **"Create Virtual MCP Server"**
    2. Fill in the details:
       * **Name**: `my-first-server`
       * **Description**: `My first MCP server setup`
    3. Click **Create Server**

    You'll get a unique endpoint like: `https://abc123.weavemcp.dev`
  </Tab>

  <Tab title="CLI Commands">
    ### CLI Configuration

    The CLI will automatically detect your virtual servers when you run:

    ```bash theme={null}
    weave configure
    ```

    This command scans for MCP clients (Claude Desktop, Claude Code, etc.) and configures them to use your WeaveMCP servers.
  </Tab>
</Tabs>

## Step 4: Add a Downstream MCP Server

Now add an actual MCP server that your virtual server will proxy to.

<AccordionGroup>
  <Accordion icon="settings" title="Web Console Configuration">
    1. Click into your newly created virtual server
    2. Click **"Add Downstream Server"**
    3. For this example, add a simple MCP server:
       * **Name**: `filesystem-server`
       * **Type**: `Command`
       * **Command**: `npx @modelcontextprotocol/server-filesystem`
       * **Args**: `/path/to/your/project`
  </Accordion>

  <Accordion icon="terminal" title="CLI Note">
    Downstream servers are managed through the web console. The CLI focuses on client configuration and proxy functionality.

    Visit your organization dashboard to add downstream servers to your virtual MCP server.
  </Accordion>
</AccordionGroup>

## Step 5: Configure Your MCP Client

<Tabs>
  <Tab title="Web Console">
    ### Web Console Steps

    1. In your virtual server detail page, click **"Client Configuration"**
    2. Copy the configuration snippet shown
    3. Add it to your MCP client configuration:

    **For Claude Desktop:** Add to `~/Library/Application Support/Claude/claude_desktop_config.json`:

    ```json theme={null}
    {
      "mcpServers": {
        "weavemcp": {
          "command": "weave",
          "args": ["proxy"],
          "env": {
            "WEAVEMCP_SERVER_URL": "https://abc123.weavemcp.dev"
          }
        }
      }
    }
    ```
  </Tab>

  <Tab title="CLI Commands">
    ### CLI Auto-Configuration

    The agent can automatically configure supported clients:

    ```bash theme={null}
    # Configure all detected clients
    weave configure --all

    # Or configure specific clients
    weave configure --client claude-desktop
    weave configure --client claude-code
    ```

    This automatically updates your client configurations to use WeaveMCP.
  </Tab>
</Tabs>

## Step 6: Test Your Setup

<Tabs>
  <Tab title="Web Console">
    ### Testing from Claude Desktop

    1. Restart Claude Desktop
    2. Start a new conversation
    3. Try an MCP request: *"Can you list the files in my project directory?"*

    If everything is working, Claude will use your filesystem MCP server through WeaveMCP!
  </Tab>

  <Tab title="CLI Commands">
    ### Testing Your Setup

    Check that everything is configured correctly:

    ```bash theme={null}
    # Verify authentication
    weave status

    # Test proxy functionality
    weave proxy --debug
    ```

    Then restart your MCP client (Claude Desktop, etc.) and try making an MCP request.
  </Tab>
</Tabs>

## What's Next?

🎉 **Congratulations!** You now have MCP servers running through WeaveMCP.

<CardGroup cols={2}>
  <Card title="Installation Guide" icon="download" href="/installation">
    Learn more about installing WeaveMCP on different platforms
  </Card>

  <Card title="Agent Deployment" icon="server" href="/setup-an-agent">
    Deploy agents to production environments
  </Card>

  <Card title="Team Management" icon="users" href="/team-management">
    Invite colleagues and manage organization settings
  </Card>

  <Card title="API Reference" icon="code" href="/api-reference/introduction">
    Explore the WeaveMCP API
  </Card>
</CardGroup>

## Need Help?

<CardGroup cols={3}>
  <Card title="Documentation" icon="book" href="https://docs.weavemcp.com">
    Browse the full documentation
  </Card>

  <Card title="GitHub Issues" icon="github" href="https://github.com/weavemcp/controlplane/issues">
    Report bugs and request features
  </Card>

  <Card title="Community Discord" icon="discord" href="https://discord.gg/weavemcp">
    Join our community for support
  </Card>
</CardGroup>