# 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.

<figure><img src="/files/d7laVp8u4Y9YbZi4S48x" alt=""><figcaption></figcaption></figure>

### 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:<br>

* Creating issues in Linear
* Searching your GitHub repositories
* Querying your database
* Accessing files in Google Drive

### Built-in MCP Tools

Nimbalyst ships its own MCP tools that any agent can call to interact with the editor:

* **AskUserQuestion** — pops up one or more multiple-choice questions in the transcript and blocks the agent until you answer.
* **PromptForUserInput** — collects several inputs at once through a single structured-prompt widget. Five field types are available: multi-select, single-select, reorder, edit-text, and confirm. Voice mode honors a `voiceFriendly` hint and defers to the screen widget for long drafts or large reorders. See [Interactive Prompts](/session-management/interactive-prompts.md) for examples and trigger phrases.
* **display\_to\_user** / **capture\_editor\_screenshot** — render charts, images, or screenshots inline in the transcript.
* **developer\_git\_commit\_proposal** — surfaces the interactive commit proposal widget instead of running `git commit` from a shell.

### 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

### Node Runtime for MCP Servers

MCP servers configured with `command: "node"` use Electron's bundled Node runtime. You don't need a system-wide Node.js install for MCP servers to work on a fresh Nimbalyst install.

### 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

<figure><img src="/files/tNlXrWA2McW6GsJtHbh2" alt=""><figcaption></figcaption></figure>

#### 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
* **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

<br>


---

# Agent Instructions: Querying This Documentation

If you need additional information that is not directly available in this page, you can query the documentation dynamically by asking a question.

Perform an HTTP GET request on the current page URL with the `ask` query parameter:

```
GET https://docs.nimbalyst.com/setup-nimbalyst/mcp.md?ask=<question>
```

The question should be specific, self-contained, and written in natural language.
The response will contain a direct answer to the question and relevant excerpts and sources from the documentation.

Use this mechanism when the answer is not explicitly present in the current page, you need clarification or additional context, or you want to retrieve related documentation sections.