What is the Wordware MCP Server?

The Wordware MCP (Model Context Protocol) server allows you to run your Wordware apps locally, integrating Wordware’s AI flows into your local development environment for easier testing and development.

What’s new in version 1.1.5 of the MCP Server?

Version 1.1.5 includes updates to work with the new local API endpoint, automatic tool discovery, interactive installation process, automatic Claude configuration setup, enhanced CLI interface, improved error handling and logging, and global installation support.

How do I install the Wordware MCP Server?

The easiest way to install is using the interactive installation process with npx wordware-mcp. Alternatively, you can install it globally using npm install -g wordware-mcp or clone the repository and install globally.

What are the prerequisites for using the Wordware MCP Server?

Before using the package, you need a Wordware account, a Wordware API key, and at least one deployed Wordware app.

How do I run Wordware MCP Server?

You can run it using npx directly (without installation) or as a global command if installed globally. Use npx wordware-mcp for interactive mode or wordware-mcp --api-key your-api-key --port 3000 with command line parameters.

How do I configure the MCP server?

You can configure the MCP server using environment variables in a .env file or by passing configuration directly via command line arguments.

How do I create a Wordware account and API key?

Create an account at wordware.ai, then create an API key by clicking on your profile picture > API keys > Create a new key.

How do I deploy a Wordware app?

Head to your app, click the “Deploy” button in the top right corner, and navigate to the deployment page. Ensure your app is deployed for it to be triggered via MCP.

How do I use the MCP server with Claude Desktop?

Modify the Claude desktop config file located at ~/Library/Application Support/Claude/claude_desktop_config.json and add the mcpServers configuration with the command set to wordware-mcp.

How do I integrate the MCP server with my application?

After starting the MCP server, your Wordware apps will be accessible at http://localhost:3000/api/run/{app_id}. You can trigger your Wordware flows via HTTP requests.

How do I resolve common issues with npx and the MCP server?

Common issues include “command not found” after installation, configuration issues, connection refused errors, and permissions issues. Refer to the troubleshooting section in the documentation for solutions to these problems.