Reliable MCP-compliant AgentForce API Server with fallback modes
npm install agentforce-reliable-serverA reliable MCP-compliant server for Salesforce AgentForce API integration.
- Connects Claude AI to Salesforce AgentForce API
- Implements the Model Context Protocol (MCP) for tool use
- Direct mode for avoiding MCP SDK compatibility issues
- Simple configuration and setup
``bashInstall globally
npm install -g agentforce-reliable-server
$3
`bash
Run the configuration wizard
npx agentforce-reliable-server configure
`You'll be prompted to:
- Set the server port (default: 3000)
- Generate a new API key (or keep existing one)
- Set the environment (production/development)
$3
#### Standard Method (Node.js)
`bash
Run in direct mode (recommended)
npx agentforce-reliable-server --direct
`#### Fix Configuration and Start (For JSON Config Issues)
If you encounter JSON configuration errors, use the fix-and-start script:
`bash
Fix configuration and start server
npx agentforce-reliable-server fix:start
`You can also fix the configuration separately:
`bash
Only fix configuration issues
npx agentforce-reliable-server fix
`#### Using Docker
The server can be run in a Docker container for easy deployment and isolation:
`bash
Run with Docker support
npx agentforce-reliable-server start:docker
`This command will:
1. Check if Docker is installed
2. Run the configuration if needed
3. Build a Docker image if it doesn't exist
4. Start the server in a container with proper volume mounts for configuration
$3
After starting the server, install and configure the AgentForce MCP Tool:
`bash
npx agentforce-mcp-tool@latest
`When prompted, enter:
- Server URL: http://localhost:3000 (or your configured port)
- API Key: (The key shown in the configuration output)
API Endpoints
-
GET /: Server info
- GET /health: Health check
- GET /mcp/resources: List available resources
- GET /mcp/tools: List available tools
- POST /mcp/call-tool: Execute a toolAdvanced Configuration
The configuration is stored in:
-
~/.agentforce-mcp-server/config.jsonYou can manually edit this file if needed.
Docker Support
The package includes a Dockerfile and docker-compose.yml for containerized deployment:
`bash
Build the image
docker build -t agentforce-reliable-server .Run with Docker directly
docker run -p 3000:3000 -v ~/.agentforce-mcp-server:/root/.agentforce-mcp-server agentforce-reliable-serverOr use docker-compose
docker-compose up -d
``MIT