Claude Desktop Configuration Guide: Complete Setup for 2026

What is Claude Desktop?

Claude Desktop is Anthropic's native application that brings the full power of Claude AI directly to your desktop. Unlike the web interface, Claude Desktop offers deeper system integration, including file access, MCP server connections, and a more responsive experience.

Installation

macOS

• Visit claude.ai/download or go to claude.ai and click "Download"
• Download the .dmg file for Apple Silicon (M1/M2/M3/M4) or Intel Macs
• Open the .dmg file and drag Claude to your Applications folder
• Launch Claude from Applications or Spotlight
• Sign in with your Anthropic account

Windows

• Visit claude.ai/download
• Download the .exe installer
• Run the installer and follow the setup wizard
• Launch Claude from your Start menu or desktop shortcut
• Sign in with your Anthropic account

Basic Configuration

After installing Claude Desktop, you can configure several settings:

• Theme: Choose between light, dark, or system-matched themes
• Default Model: Select your preferred Claude model (Sonnet 4, Opus 4, etc.)
• Output Language: Set your preferred response language
• Artifact Handling: Configure how code blocks and artifacts are displayed

MCP Server Setup

Model Context Protocol (MCP) servers extend Claude Desktop's capabilities by connecting it to external tools, data sources, and services. This is one of the most powerful features of Claude Desktop.

What is MCP?

MCP (Model Context Protocol) is an open protocol that allows AI models to securely interact with external tools and data sources. With MCP servers, Claude Desktop can:

• Read and write files on your computer
• Query databases
• Search the web
• Interact with APIs like GitHub, Slack, and Google Drive
• Run custom tools and scripts

Adding Your First MCP Server

• Open Claude Desktop Settings
• Navigate to the "Developer" section
• Click "Edit Config" to open the configuration file
• Add your MCP server configuration in JSON format:

{
  "mcpServers": {
    "filesystem": {
      "command": "npx",
      "args": ["-y", "@anthropic-ai/mcp-server-filesystem", "/path/to/your/project"]
    }
  }
}

• Save the file and restart Claude Desktop
• You should see a hammer icon indicating MCP tools are available

Popular MCP Servers

Here are some of the most useful MCP servers for Claude Desktop:

• Filesystem: Read and write files on your computer
• GitHub: Interact with GitHub repositories, issues, and pull requests
• PostgreSQL: Query PostgreSQL databases directly
• Brave Search: Search the web using Brave Search API
• Slack: Read and send Slack messages
• Google Drive: Access and search Google Drive files

Advanced Features

Conversation Management

Claude Desktop automatically saves your conversation history. You can:

• Access previous conversations from the sidebar
• Pin important conversations for quick access
• Export conversations as text or markdown
• Search through conversation history

File Upload and Analysis

Claude Desktop supports uploading and analyzing various file types:

• Documents: PDF, DOCX, TXT, Markdown
• Images: PNG, JPG, GIF (with vision analysis)
• Data: CSV, JSON, XML
• Code: Any programming language file

Keyboard Shortcuts

Speed up your workflow with these essential shortcuts:

• Cmd/Ctrl + N: New conversation
• Cmd/Ctrl + Shift + N: New temporary chat
• Cmd/Ctrl + ,: Open settings
• Cmd/Ctrl + Shift + C: Copy last response

Troubleshooting

Common Issues

Claude Desktop won't start:

• Ensure you have the latest version downloaded
• Check that your operating system meets the minimum requirements (macOS 12+ or Windows 10+)
• Try reinstalling the application

MCP servers not showing up:

• Verify the JSON configuration is valid
• Ensure the MCP server package is installed (run npm install -g if needed)
• Restart Claude Desktop after configuration changes
• Check the Developer console for error messages

Slow responses:

• Check your internet connection
• Try switching to a faster model (Sonnet 4 instead of Opus 4)
• Clear conversation history if it has become very long

API key issues:

• For API access, ensure your ANTHROPIC_API_KEY is set correctly
• Check that your API plan supports the model you're trying to use
• Verify your usage limits haven't been exceeded

Getting Help

If you encounter issues not covered here:

• Check the Anthropic Status Page
• Visit the Claude Desktop documentation
• Contact Anthropic support through claude.ai

Best Practices

• Use Projects: Organize related conversations into projects for better context management
• Leverage MCP: Set up MCP servers for your most common workflows to dramatically increase productivity
• System Prompts: Use custom system prompts to tailor Claude's behavior for specific tasks
• Batch Similar Tasks: Group similar questions together to maintain context and get more consistent results
• Review Artifacts: Always review generated code and content before using it in production