MCP Server

1. Open Claude Desktop’s configuration file:
   • macOS: ~/Library/Application Support/Claude/claude_desktop_config.json
   • Windows: %APPDATA%\Claude\claude_desktop_config.json
2. Add the ShipBob MCP server configuration:

{
  "mcpServers": {
    "shipbob-developer-api": {
      "url": "https://api.shipbob.com/developer-api/mcp",
      "transportType": "http",
      "headers": {
        "Authorization": "Bearer YOUR_API_TOKEN"
      }
    }
  }
}

3. Replace YOUR_API_TOKEN with your actual ShipBob API token
4. Restart Claude Desktop
5. Verify the connection by asking Claude: “What ShipBob tools are available?”

Prerequisites:

• Install the latest version of Visual Studio Code
• Have access to GitHub Copilot

1. Create Configuration File:
   • Workspace: Create .vscode/mcp.json in your workspace folder
   • User Profile: Use the command MCP: Open User Configuration from the Command Palette (Ctrl+Shift+P)
2. Add ShipBob MCP Server Configuration:

{
  "servers": {
    "shipbob-developer-api": {
      "type": "http",
      "url": "https://api.shipbob.com/developer-api/mcp",
      "headers": {
        "Authorization": "Bearer ${input:shipbob-api-token}"
      }
    }
  },
  "inputs": [
    {
      "type": "promptString",
      "id": "shipbob-api-token",
      "description": "ShipBob API Token",
      "password": true
    }
  ]
}

{
  "servers": {
    "shipbob-developer-api": {
      "type": "http",
      "url": "https://api.shipbob.com/developer-api/mcp",
      "headers": {
        "Authorization": "Bearer ${env:SHIPBOB_API_TOKEN}"
      }
    }
  }
}

3. When you start using the MCP server, VS Code will prompt you for your API token (if using ${input:}), or ensure the SHIPBOB_API_TOKEN environment variable is set (if using ${env:})
4. Trust the Server: When VS Code prompts you to trust the MCP server configuration, review the details and confirm
5. Start the Server: Run MCP: List Servers from the Command Palette and start the ShipBob Developer API server
6. Verify the connection by opening Copilot Chat and asking: “What ShipBob tools are available?”

1. Use the appropriate ShipBob MCP endpoint:
   • Sandbox: https://sandbox-api.shipbob.com/developer-api/mcp
   • Production: https://api.shipbob.com/developer-api/mcp
2. Configure authentication using your ShipBob API token in the Authorization header:
   Report incorrect code

   Copy

   Ask AI

   Authorization: Bearer YOUR_API_TOKEN
   
3. Follow your client’s specific MCP configuration instructions
4. Verify the connection by listing available tools

• Get orders list with filtering
• Get order details by order ID
• Get shipments by order ID
• Get shipment details
• Get shipment timeline and logs
• Get shipping methods
• View store order JSON

• List all products
• Get product details by product ID
• Get product variants
• Browse product taxonomy
• Get taxonomy hierarchy
• View packaging requirements

• Get inventory list
• Get inventory levels by inventory ID
• View inventory across locations
• Get lot information
• Track inventory by fulfillment center

• View channel

1. Verify you’re using the correct endpoint URL:
   • Sandbox: https://sandbox-api.shipbob.com/developer-api/mcp
   • Production: https://api.shipbob.com/developer-api/mcp
2. Check your internet connection
3. Ensure your AI assistant supports MCP protocol
4. Verify your configuration file syntax is correct

1. Verify your ShipBob API token is valid
2. Check token hasn’t expired (regenerate if needed)
3. Ensure the Authorization header is properly formatted: Bearer YOUR_TOKEN
4. Confirm you’re using the right token for the environment (sandbox vs production)

1. Verify the MCP server configuration in your AI assistant
2. Restart your AI assistant after configuration changes
3. Check that your API token has the necessary permissions
4. Try asking: “What ShipBob tools are available?”

1. Check that required parameters are provided
2. Verify parameter formats match API requirements (e.g., dates, IDs)
3. Review error message for specific guidance
4. Consult ShipBob API documentation for parameter details
5. Ensure you have permissions for the operation

1. Check ShipBob API rate limits
2. Reduce the frequency of requests
3. Use batch operations when available

1. Verify you’re using the correct environment (sandbox vs production)
2. Check that data exists in your ShipBob account
3. Ensure you have the right permissions to view the data
4. Try the same query directly in the ShipBob dashboard

• Sandbox: https://sandbox-api.shipbob.com/developer-api/mcp + sandbox token
• Production: https://api.shipbob.com/developer-api/mcp + production token