MCP connector for Bison Hello API
npm install inboxassure-mcpx-devbash
npm install -g inboxassure-mcpx-dev
`
API Key
To use this package, you need a valid API key from InboxAssure.
The API key must follow this format: iak_* (starts with "iak_" followed by a string of characters).
Contact InboxAssure support to obtain an API key if you don't have one.
Usage with Claude Desktop
Add this to your Claude desktop configuration, replacing YOUR_API_KEY with your actual API key:
`json
{
"mcpServers": {
"My Bison Hello Server": {
"command": "npx",
"args": [
"-y",
"inboxassure-mcpx-dev",
"--api-key=YOUR_API_KEY"
]
}
}
}
`
For Windows users, you can also use:
`json
{
"mcpServers": {
"My Bison Hello Server": {
"command": "cmd",
"args": [
"/c",
"npx",
"-y",
"inboxassure-mcpx-dev",
"--api-key=YOUR_API_KEY"
]
}
}
}
`
After adding this configuration:
1. Save the file
2. Restart Claude desktop
3. You should see the Bison Hello Server tool available
Available Tools
- get_bison_hello: Gets a greeting from the Bison Hello API.
Troubleshooting
If you encounter issues:
1. Check the Claude logs (%APPDATA%\Claude\logs\mcp*.log on Windows)
2. Make sure you have Node.js installed (version 14 or higher)
3. Verify that your API key is valid and properly formatted
4. Try running the package directly with npx inboxassure-mcpx-dev --api-key=YOUR_API_KEY
5. Check your internet connection and ensure you can reach the InboxAssure API server
$3
- Invalid API key format: Make sure your API key starts with "iak_" and is sufficiently long
- Server error: Request timed out: The API server could not be reached within 10 seconds
- Server returned 401: Unauthorized: Your API key is invalid or expired
Development
This package acts as a bridge between Claude desktop and the InboxAssure Bison API server. It:
1. Accepts MCP protocol messages from Claude
2. Forwards them to the InboxAssure server
3. Returns the responses back to Claude
$3
1. Clone the repository
2. Install dependencies with npm install
3. Run the bridge with npm start -- --api-key=YOUR_API_KEY`