Athena — mahmoud-consultancy/archive/old-docs/CLAUDE-DESKTOP-SETUP.md

Claude Desktop Setup Guide

You now have Claude Desktop configured to work on your mahmoud-consultancy project using your Pro/Max subscription (no API charges!).

✅ What's Configured

I've set up two MCP servers for Claude Desktop:

  1. Filesystem Server - Full read/write access to your project
  2. Git Server - Git operations (commit, push, status, diff)

🚀 How to Use

Step 1: Restart Claude Desktop

  1. Quit Claude Desktop completely (Cmd+Q)
  2. Reopen Claude Desktop
  3. Look for the 🔌 icon at the bottom - this shows MCP servers are connected

Step 2: Start Working with Your Project

Open Claude Desktop and try these prompts:

Initial Analysis:

I have a project at /Users/sarkout/projects/prive/mahmoud-consultancy.
Can you analyze the codebase and identify the top 5 improvements I should make?

Make Improvements:

Please implement the database indexes we discussed and commit the changes to git.

Add Tests:

Find all services without unit tests and create comprehensive test coverage.
Commit each test file as you create it.

Fix Issues:

Search for TODO comments and FIXMEs in the codebase and fix them one by one.
Commit each fix with a descriptive message.

💡 Tips for Continuous Work

Create a "Work Session" Prompt

Save this as a project in Claude Desktop for repeated use:

You are working on the mahmoud-consultancy project. This is an autonomous work session.

Your tasks:
1. Analyze the codebase for issues, TODOs, missing tests, or improvements
2. Pick the highest priority task
3. Implement it completely with high quality
4. Write/update tests as needed
5. Commit changes to git with descriptive messages
6. Move to the next task

Focus areas:
- Security vulnerabilities
- Missing test coverage
- Performance optimizations
- Code quality issues
- Documentation gaps
- Sprint 1 completion

Work autonomously - implement improvements without asking permission.
After each improvement, commit to git and continue to the next task.

🔍 Verify MCP is Working

In Claude Desktop, type:

Can you list the files in my mahmoud-consultancy project?

If you see file listings, MCP is working! ✅

📊 Benefits vs API-based Approach

| Feature | Claude Desktop (MCP) | Docker + API | |---------|---------------------|--------------| | Cost | ✅ Free (uses Pro/Max) | ❌ Pay per API call | | Interactive | ✅ Full conversation | ❌ One-shot responses | | File Access | ✅ Full read/write | ✅ Full read/write | | Git Access | ✅ Built-in | ✅ Built-in | | Autonomous | ⚠️ Semi-autonomous | ✅ Fully autonomous | | Monitoring | ✅ Real-time in app | ⚠️ View logs |

🎯 Recommended Workflow

Daily Development:

  1. Open Claude Desktop in the morning
  2. Give it the "Work Session" prompt above
  3. Let it work through 3-5 improvements
  4. Review the commits
  5. Push to your branch when satisfied

Focused Tasks:

Please focus on [specific area] for the next hour:
- Fix all authentication edge cases
- Add integration tests for job posting
- Optimize database queries
- etc.

Commit each improvement as you go.

🔧 Troubleshooting

MCP Not Showing Up?

  1. Ensure you completely quit Claude Desktop (not just closed the window)
  2. Check for the 🔌 icon at the bottom of Claude Desktop
  3. If still not working, check Settings → Developer → MCP Servers

Can't Access Files?

Make sure the path in claude_desktop_config.json is correct:

/Users/sarkout/projects/prive/mahmoud-consultancy

Git Operations Failing?

Ensure you're logged into git in your terminal:

git config --global user.name "Your Name"
git config --global user.email "your@email.com"

📝 Configuration Location

Your MCP config is stored at:

~/Library/Application Support/Claude/claude_desktop_config.json

🎉 You're All Set!

You can now use Claude Desktop with your Pro/Max subscription to work on your project continuously without API charges. Just open the app and start giving it tasks!


Note: The Docker approach we set up earlier uses API calls. With Claude Desktop + MCP, you're using your Pro/Max subscription instead, which is unlimited and free!

Reacties

Nog geen reacties