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:- Web Console
- CLI Commands
Web Console
- Go to console.weavemcp.com
- Click Sign in with GitHub or Sign in with Google
- Authorize WeaveMCP to access your account
Step 2: Organization Setup
- Web Console
- CLI Commands
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)
Step 3: Create Your First Virtual MCP Server
- Web Console
- CLI Commands
Web Console Steps
- From your organization dashboard, click “Create Virtual MCP Server”
- Fill in the details:
- Name:
my-first-server - Description:
My first MCP server setup
- Name:
- Click Create Server
https://abc123.weavemcp.devStep 4: Add a Downstream MCP Server
Now add an actual MCP server that your virtual server will proxy to.Web Console Configuration
Web Console Configuration
- Click into your newly created virtual server
- Click “Add Downstream Server”
- For this example, add a simple MCP server:
- Name:
filesystem-server - Type:
Command - Command:
npx @modelcontextprotocol/server-filesystem - Args:
/path/to/your/project
- Name:
CLI Note
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.
Step 5: Configure Your MCP Client
- Web Console
- CLI Commands
Web Console Steps
- In your virtual server detail page, click “Client Configuration”
- Copy the configuration snippet shown
- Add it to your MCP client configuration:
~/Library/Application Support/Claude/claude_desktop_config.json:Step 6: Test Your Setup
- Web Console
- CLI Commands
Testing from Claude Desktop
- Restart Claude Desktop
- Start a new conversation
- Try an MCP request: “Can you list the files in my project directory?”
What’s Next?
🎉 Congratulations! You now have MCP servers running through WeaveMCP.Installation Guide
Learn more about installing WeaveMCP on different platforms
Agent Deployment
Deploy agents to production environments
Team Management
Invite colleagues and manage organization settings
API Reference
Explore the WeaveMCP API