You can connect BalkanID MCP to any AI assistant that supports the Model Context Protocol.
Pre-requisites
Node.js: 18 LTS or later
npm: 9.x or later
Active BalkanID tenant
MCP-compatible AI
1
Step 1 - API Key
Navigate to mcp.app.balkan.id -> Generate New API Key
Give the key a name (e.g. claude-mcp) and copy it and store it securely— it is only shown once
API Key Scopes:
Read: Allows all read operations
Write: Allows write operations like create/edit
API keys are not permitted to remain active for more than 90 days. This is because API keys are generally considered high-risk credentials across systems, and regular rotation is a recommended security best practice.
2
Step 2 - Common Setups
Claude Desktop
Click on "Connect" → "Connect to Claude" and follow along the instructions
Open Developer settings
In Claude Desktop, go to Settings → Developer. If you have never used MCP, turn on Developer (or MCP) so the app can use a config file.
Paste the JSON
Copy full config if the file is new or empty. If you already have other servers, use Copy server entry and paste it inside mcpServers, with a comma between entries so the JSON stays valid.
Copy the JSON that is prompted in the UI
Restart Claude
Save the file, quit Claude Desktop completely, and open it again. You should see the MCP (hammer) icon by the chat box.
VS Code
Click on “Connect” → “Connect to VS Code” and follow the one-click installation process.
Cursor
Click on “Connect” → “Connect to VS Code” and follow the one-click installation process
3
Step 3 - Verification
Verify the connection. The BalkanID MCP server should now be accessible through the setup MCP-compatible AI agent
