setup-mcp

name	setup-mcp
description	Interactive wizard to set up MCP server credentials in your shell environment (~/.zshenv, ~/.bashrc, etc.). Activates when the user needs to configure API keys, tokens, or environment variables for MCP servers, or after adding new MCP integrations that require authentication.

MCP Server Credential Setup Wizard

Guides the user through setting up environment variables for MCP server authentication. Since Terrazul passes MCP configuration via CLI flags, credentials must be persisted in shell environment files.

Instructions

This is an interactive setup flow. Guide the user through ONE credential at a time using AskUserQuestion to confirm progress.

Workflow

Step 1: Detect Shell Environment

Determine the user's shell and appropriate config file:

echo $SHELL

Shell	Recommended File	Alternative
zsh	~/.zshenv	~/.zshrc
bash	~/.bashrc	~/.bash_profile

Why ~/.zshenv? Environment variables in .zshenv are loaded for all shell sessions (interactive and non-interactive), ensuring MCP servers always have access to credentials.

Ask the user which file they want to use if multiple options exist. Default to ~/.zshenv for zsh users.

Step 2: Identify Required Credentials

Read the project's MCP configuration to find which environment variables are needed. Check:

1. .claude/settings.local.json - Local project MCP config