Finizi B4B MCP Server

# Finizi B4B MCP Server - Usage Summary ## ✅ Server is Ready! The MCP server has been successfully built and is ready to use. --- ## 🚀 Quick Start (3 Steps) ### 1. Open Claude Desktop Config ```bash open ~/Library/Application\ Support/Claude/claude_desktop_config.json ``` ### 2. Add This Configuration ```json { "mcpServers": { "finizi-b4b": { "command": "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" } } } } ``` ### 3. Restart Claude Desktop Quit completely (`Cmd + Q`) and restart. --- ## 💬 Test It In Claude Desktop, try: ``` "Login to B4B with phone +84909495665 and password Admin123@" "List my entities" "Show me what B4B tools are available" ``` --- ## 📚 Available Tools (15 Total) ### Authentication (3) - `login` `logout` `whoami` ### Entities (4) - `list_entities` `get_entity` `create_entity` `update_entity` ### Invoices (4) - `list_invoices` `get_invoice` `import_invoice_xml` `get_invoice_statistics` ### Vendors (2) - `list_vendors` `get_vendor` ### Products (2) - `list_products` `search_similar_products` --- ## 📖 Documentation - **[CLAUDE_DESKTOP_SETUP.md](CLAUDE_DESKTOP_SETUP.md)** - Detailed setup guide - **[README.md](README.md)** - Full documentation - **[docs/API_MAPPING.md](docs/API_MAPPING.md)** - API reference - **[docs/DEVELOPMENT.md](docs/DEVELOPMENT.md)** - Developer guide --- ## 🔧 Troubleshooting **Server not appearing?** ```bash # Check config syntax cat ~/Library/Application\ Support/Claude/claude_desktop_config.json | python -m json.tool # Check logs tail -f ~/Library/Logs/Claude/mcp*.log # Test manually cd /Users/trunghuynh/development/finizi-mcp uv run python -m finizi_b4b_mcp.server ``` **Need help?** See [CLAUDE_DESKTOP_SETUP.md](CLAUDE_DESKTOP_SETUP.md) for detailed troubleshooting. --- ## ✨ What You Can Do - 🔐 Authenticate with B4B API - 🏢 Manage business entities - 📄 View and import invoices - 👥 Manage vendors - 📦 Search products with AI - 📊 Get analytics and statistics **All through natural language with Claude!** 🎉