CLAUDE_DESKTOP_SETUP.md•6.6 kB
# 🎯 Claude Desktop Setup Guide
## Quick Answer
**You DON'T put files IN Claude Desktop.**
**You CONFIGURE Claude Desktop to CONNECT to your MCP server.**
---
## 📝 Step-by-Step Setup
### **Step 1: Locate Claude Desktop Config File**
**Windows** (your system):
```
C:\Users\pbkap\AppData\Roaming\Claude\claude_desktop_config.json
```
**Quick access**:
1. Press `Win + R`
2. Type: `%APPDATA%\Claude`
3. Press Enter
4. Open `claude_desktop_config.json`
---
### **Step 2: Edit Configuration File**
Open `claude_desktop_config.json` in Notepad and add this:
```json
{
"mcpServers": {
"enhanced-google-services": {
"command": "python",
"args": [
"C:\\Users\\pbkap\\Documents\\euron\\Projects\\mcpwithgoogle\\enhanced-mcp-server\\src\\mcp_server.py"
],
"env": {}
}
}
}
```
**✅ Save and close the file**
---
### **Step 3: Restart Claude Desktop**
1. **Completely quit** Claude Desktop (not just close the window)
- Right-click Claude in system tray → Quit
- Or use Task Manager to end the process
2. **Restart** Claude Desktop
3. Your tools should now be available!
---
## ✅ **Verify It's Working**
### **In Claude Desktop, ask:**
```
Show me available tools
```
**You should see 4 tools**:
- ✅ `test_llm` - Test LLM fallback system
- ✅ `llm_health` - Check LLM provider health
- ✅ `ai_assistant` - Intelligent AI assistant
- ✅ `show_config` - Show configuration
---
### **Test the LLM system:**
```
Use the test_llm tool to send "Hello, world!" to the LLM
```
**Expected response**:
```json
{
"success": true,
"provider_used": "euron",
"response": "Hello! How can I help you today?",
"usage": {
"prompt_tokens": 10,
"completion_tokens": 8,
"total_tokens": 18
},
"cost": 0.000009,
"latency": 1.23
}
```
---
### **Check provider health:**
```
Check the health of all LLM providers
```
**Expected response**:
```json
{
"success": true,
"health": {
"total_requests": 1,
"fallback_count": 0,
"providers": {
"euron": {
"status": "healthy",
"success_rate": 1.0,
"total_calls": 1
},
"deepseek": {
"status": "healthy",
"success_rate": 0.0
},
"gemini": {
"status": "healthy",
"success_rate": 0.0
}
}
}
}
```
---
## 🎯 **How It Works**
```
┌─────────────────────┐
│ Claude Desktop │
│ (Frontend) │
└──────────┬──────────┘
│
│ JSON-RPC via stdio
│
▼
┌─────────────────────┐
│ MCP Server │
│ (Your Python code) │
│ │
│ Location: │
│ enhanced-mcp- │
│ server/src/ │
│ mcp_server.py │
└──────────┬──────────┘
│
▼
┌─────────────────────┐
│ Your Tools │
│ - test_llm │
│ - llm_health │
│ - ai_assistant │
│ - show_config │
└─────────────────────┘
```
**Claude Desktop**:
- Runs on your machine (GUI app)
- You chat with it normally
- It has access to your MCP tools
**MCP Server**:
- Runs as a background process
- Started automatically by Claude Desktop
- Located in your project folder
- Never moves or copies files
---
## 📂 **File Locations Summary**
### **Claude Desktop Config** (You edit this):
```
C:\Users\pbkap\AppData\Roaming\Claude\claude_desktop_config.json
```
### **Your MCP Server** (Stays in your project):
```
C:\Users\pbkap\Documents\euron\Projects\mcpwithgoogle\enhanced-mcp-server\src\mcp_server.py
```
### **Your Configuration** (Your API keys):
```
C:\Users\pbkap\Documents\euron\Projects\mcpwithgoogle\enhanced-mcp-server\.env
```
---
## 🔧 **Troubleshooting**
### **Tools not showing up?**
1. **Check config path is correct**:
```bash
# Verify file exists
python -c "from pathlib import Path; print(Path('C:/Users/pbkap/Documents/euron/Projects/mcpwithgoogle/enhanced-mcp-server/src/mcp_server.py').exists())"
```
Should print: `True`
2. **Check Python is in PATH**:
```bash
python --version
```
Should show Python 3.8+
3. **Test MCP server manually**:
```bash
cd C:\Users\pbkap\Documents\euron\Projects\mcpwithgoogle\enhanced-mcp-server
python src\mcp_server.py
```
Should show: "Enhanced MCP Server Starting"
4. **Check Claude Desktop logs**:
```
%APPDATA%\Claude\logs\
```
### **Error: "Module not found"?**
Install dependencies:
```bash
cd C:\Users\pbkap\Documents\euron\Projects\mcpwithgoogle\enhanced-mcp-server
pip install -r requirements.txt
```
### **Error: "Configuration not found"?**
Make sure `.env` file exists:
```bash
dir C:\Users\pbkap\Documents\euron\Projects\mcpwithgoogle\enhanced-mcp-server\.env
```
---
## ✨ **Example Usage in Claude Desktop**
### **1. Test LLM System**
```
Test the LLM with prompt "What is 2+2?"
```
### **2. Use AI Assistant**
```
Use the ai_assistant tool to summarize this text: [paste text]
```
### **3. Check Health**
```
What's the health status of my LLM providers?
```
### **4. Check Configuration**
```
Show me my current MCP server configuration
```
---
## 🎉 **That's It!**
You've successfully connected Claude Desktop to your Enhanced MCP Server!
**What you did**:
1. ✅ Created `claude_desktop_config.json` entry
2. ✅ Pointed it to your `mcp_server.py`
3. ✅ Restarted Claude Desktop
**What happens now**:
- Claude Desktop automatically starts your MCP server
- Your tools are available in conversations
- The LLM fallback system is ready to use
---
## 🚀 **Next Steps**
Now that your MCP server is connected, you can:
1. **Test the tools** - Try the examples above
2. **Add more tools** - Follow `COMPLETE_IMPLEMENTATION_GUIDE.md`
3. **Implement Gmail** - Add email tools
4. **Add Calendar** - Add calendar tools
5. **Build workflows** - Create automated workflows
---
## 📞 **Quick Reference**
| Task | Command |
|------|---------|
| **Open config** | `notepad %APPDATA%\Claude\claude_desktop_config.json` |
| **Test server** | `python src\mcp_server.py` |
| **Check logs** | `dir %APPDATA%\Claude\logs\` |
| **Restart Claude** | Quit and reopen Claude Desktop |
---
<div align="center">
**✅ Setup Complete!**
Your MCP server is now integrated with Claude Desktop!
</div>