Finizi B4B MCP Server

# 🚀 Finizi B4B MCP Server - Quick Setup (5 Minutes) ## The Issue You Had **Error:** `spawn uv ENOENT` **Cause:** Claude Desktop couldn't find the `uv` command in its PATH. **Solution:** Use the full path to `uv` in the configuration. --- ## ✅ Working Configuration ### Step 1: Copy This Exact Configuration Open your Claude Desktop config: ```bash open ~/Library/Application\ Support/Claude/claude_desktop_config.json ``` **Replace the entire content** with this (or merge if you have other servers): ```json { "mcpServers": { "finizi-b4b": { "command": "/Users/trunghuynh/.local/bin/uv", "args": [ "--directory", "/Users/trunghuynh/development/finizi-mcp", "run", "python", "-m", "finizi_b4b_mcp.server" ], "env": { "B4B_API_BASE_URL": "http://localhost:8000", "B4B_API_VERSION": "v1", "LOG_LEVEL": "INFO" } } } } ``` **Key Change:** Using full path `/Users/trunghuynh/.local/bin/uv` instead of just `uv` ### Step 2: Save and Restart Claude Desktop 1. Save the file (`Cmd + S`) 2. **Completely quit** Claude Desktop (`Cmd + Q`) 3. Open Claude Desktop again ### Step 3: Verify It Works Look for the 🔌 MCP icon in the bottom-right corner of Claude Desktop. Then test with: ``` "What MCP servers are connected?" "Login to B4B with phone +84909495665 password Admin123@" "List my entities" ``` --- ## 🎯 If You Have Other MCP Servers Merge the configuration like this: ```json { "mcpServers": { "your-existing-server": { "command": "node", "args": ["path/to/your/server.js"] }, "finizi-b4b": { "command": "/Users/trunghuynh/.local/bin/uv", "args": [ "--directory", "/Users/trunghuynh/development/finizi-mcp", "run", "python", "-m", "finizi_b4b_mcp.server" ], "env": { "B4B_API_BASE_URL": "http://localhost:8000", "B4B_API_VERSION": "v1" } } } } ``` --- ## 🔍 Troubleshooting ### Still Getting Errors? **Check the logs:** ```bash tail -f ~/Library/Logs/Claude/mcp-server-finizi-b4b.log ``` **Test manually:** ```bash /Users/trunghuynh/.local/bin/uv --directory /Users/trunghuynh/development/finizi-mcp run python -m finizi_b4b_mcp.server ``` If this works, the issue is with Claude Desktop configuration. ### Different UV Location? Find where your `uv` is installed: ```bash which uv ``` Then use that path in the `command` field. --- ## ✨ What You Can Do Now Once connected, you have access to **15 B4B tools**: ### Authentication ``` "Login to B4B with phone +84909495665 password Admin123@" "Who am I logged in as?" "Logout" ``` ### Entity Management ``` "List my business entities" "Show details for entity [id]" "Create a new company named ABC Corp with tax ID 0123456789" ``` ### Invoice Management ``` "Show me invoices for entity [id] from January 2025" "Get invoice [id] details" "Import this XML invoice: [xml content]" "Show invoice statistics for 2025" ``` ### Vendors & Products ``` "List all vendors for entity [id]" "Find products similar to 'laptop'" ``` --- ## 📚 More Documentation - **[README.md](README.md)** - Complete documentation - **[USAGE_SUMMARY.md](USAGE_SUMMARY.md)** - Quick reference - **[docs/API_MAPPING.md](docs/API_MAPPING.md)** - API reference --- ## ⚡ Quick Test After setup, verify everything works: 1. **Login:** ``` "Login to B4B with phone +84909495665 password Admin123@" ``` Should respond: ✓ Successfully logged in 2. **List entities:** ``` "List my entities" ``` Should show your business entities 3. **Check tools:** ``` "What B4B tools are available?" ``` Should list all 15 tools --- **That's it!** 🎉 Your MCP server is now properly configured and ready to use. The key was using the full path to `uv` so Claude Desktop can find it.