Skip to main content

​
Get Started with Runlayer

Start using MCP servers with your AI tools in minutes. This guide will walk you through your first login, choosing an MCP, and connecting it to your AI client.
Your administrator has already set up Runlayer for your organization. You just need to log in and start using it!

​
Step 1: Login

Sign In
  1. Navigate to your organization’s Runlayer URL (provided by your admin)
  2. Click “Sign In” - You’ll be redirected to your organization’s Single Sign-On (SSO) page
  3. Log in with your work credentials - Same username and password you use for other company tools

​
Step 2: Choose an MCP

Catalog Browse the MCP catalog to find the tools you need:
  1. Navigate to Catalog in the left sidebar
  2. Browse or search for MCPs by name or category
  3. Click on any MCP to see details:
    • What it does
    • What tools it provides
    • What data it can access
  4. Click “Add Server” to request access
Popular MCPs:
  • GitHub - Access code repositories, create issues, search code
  • Brave Search - Web search capabilities
  • PostgreSQL - Query databases
  • Slack - Read messages, post updates
  • Google Drive - Access documents and files
If the MCP you need isn’t in the catalog, you can request a custom MCP. See the Employee Handbook for details.

​
Step 3: Connect to Your AI Client

MCP Clients Once your MCP is approved, connect it to your AI tool:

​
Connection Steps

1

Open the MCP Details

Click on any Active MCP in your MCPs list
2

Select Your AI Tool

Choose your client from the dropdown:IDEs & Code Editors:
  • Cursor, VS Code, Windsurf, GitHub Copilot
AI Assistants:
  • Claude Desktop, Claude Code, ChatGPT, Codex
Terminal & CLI Tools:
  • Warp, Gemini CLI
Automation & Integration:
  • Gumloop, Raycast
SDKs (for developers):
  • TypeScript SDK, Python SDK
3

Follow the Instructions

Runlayer provides complete, step-by-step instructions for your specific client:
  • Exact commands to run (for CLI-based tools)
  • Configuration files to copy (for file-based tools)
  • Connect buttons (for supported IDEs)
  • Web UI steps (for browser-based tools)
4

Start Using MCPs

Once connected, you can use MCP tools directly in your AI client!
Security Note: Your API key provides access to the MCP server. Never share your API key or configuration files publicly.

​
What’s Next?

Now that you’re set up, explore what you can do:

View Audit Logs

See all your MCP activity and troubleshoot issues

Request More MCPs

Browse the catalog and request additional MCP servers

Employee Handbook

Complete guide for using Runlayer

Security Best Practices

Learn how to use MCPs securely

​
Common Questions

You’ll receive a notification via email and in the Runlayer app. The MCP status will change from “Pending” to “Active”.
Yes! Generate one API key and use it on all your devices. The same configuration works on your work laptop, home computer, etc.
Use the “Create Custom Server” option to request it. Your admin will review and approve custom MCP requests.
Try these quick fixes:
  1. Restart your AI tool completely (quit and reopen)
  2. Verify the MCP is “Active” in Runlayer
  3. Try disconnecting and reconnecting

​
Getting Help

Common Issues

Troubleshooting guide for common problems

Admin Handbook

For administrators managing Runlayer

Email Support

[email protected]

Documentation

Complete employee handbook