MCP

MCP (Model Context Protocol) servers extend what your coding agent can do in Nimbalyst. They give your agent access to external services like GitHub, Linear, Slack, and more.

What Are MCP Servers?

MCP servers are connectors that let your coding agent interact with other apps and services. When you connect an MCP server, the agent gains new abilities like:

  • Creating issues in Linear

  • Searching your GitHub repositories

  • Querying your database

  • Accessing files in Google Drive

Calling a Configured MCP Server from Chat

Just refer to the MCP server in your chat and your coding agent will figure out you need to use it

For example:

  • "Add these to a Linear ticket"

  • "Analyze this cohort in PostHog"

User vs Workspace Servers

You can configure servers at two levels:

User Level (Global)

  • Available in all your projects

  • Good for personal tools you always want access to

  • Example: Your personal GitHub account

Workspace Level (Project)

  • Only available in a specific project

  • Good for project-specific services

  • Example: A project's database connection

Adding MCP Servers

Some servers require authentication:

  1. Open Settings (gear icon or Cmd/Ctrl + ,)

  2. Go to AI > MCP Servers

  3. Click Add Server

  4. Choose from a template or configure manually

Available Templates

Nimbalyst includes ready-to-use templates for popular services:

  • GitHub - Work with repositories, issues, and pull requests

  • GitLab - DevOps and repository management

Productivity

  • Linear - Issue tracking and project management

  • Notion - Access your workspace and pages

  • Slack - Team communication

  • Asana - Task management

  • Atlassian - Jira and Confluence

Data & Analytics

  • PostgreSQL - Query databases

  • PostHog - Product analytics

Design

  • Figma - Access Figma designs and assets

Search

  • Brave Search - Web search capabilities

Files

  • Google Drive - Access your documents

  • Filesystem - Access local files

From the Settings Panel

  • API Key: Enter your API key in the server settings

  • OAuth: Click "Authorize" and sign in through your browser

Checking Server Status

In the MCP Servers settings, each server shows its status:

  • Connected - Working and ready to use

  • Not authorized - Needs authentication (click Authorize)

  • Error - Something went wrong (check the error message)

Troubleshooting

Server not appearing in your agent's tools?

  • Make sure the server is enabled (not disabled)

  • Check that authentication is complete

  • Try restarting Nimbalyst

OAuth authorization failed?

  • Complete the sign-in process in your browser

  • Try revoking and re-authorizing

  • Check your internet connection

API key not working?

  • Verify the key is correct (no extra spaces)

  • Check that the key has the required permissions

  • Some services require specific scopes or access levels

Privacy & Security

  • All MCP connections are made locally from your computer

  • API keys and tokens are stored securely on your machine

  • OAuth tokens can be revoked at any time from settings

  • No credentials are sent to Nimbalyst servers

Last updated