DeepWriter MCP

Using DeepWriter MCP

The DeepWriter Model Context Protocol (MCP) server allows you to seamlessly integrate DeepWriter's content generation capabilities with Claude and other MCP-compatible AI assistants. This guide will help you set up and use the DeepWriter MCP server.

Prerequisites

Before getting started, ensure you have:

• Node.js (v17 or higher)

• npm (v6 or higher)

• A DeepWriter API key (see Getting Your API Key)

• An MCP-compatible client (such as Claude for Desktop)

Installation

1. Clone the repository:

   bashgit clone https://github.com/yourusername/deepwriter-mcp.gitcd deepwriter-mcp

2. Install dependencies:

   bashnpm install

3. Create a .env file in the root directory with your DeepWriter API key:

   DEEPWRITER_API_KEY=your_api_key_here

4. Build the project:

   bashnpm run build

Integration with Claude for Desktop

To connect the DeepWriter MCP server with Claude for Desktop:

1. Open your Claude for Desktop configuration file:

   • macOS: ~/Library/Application Support/Claude/claude_desktop_config.json

   • Windows: %APPDATA%\Claude\claude_desktop_config.json

2. Add the server configuration:

   json{  "mcpServers": {    "deepwriter": {      "command": "node",      "args": ["/ABSOLUTE/PATH/TO/deepwriter-mcp/build/index.js"],      "env": {        "DEEPWRITER_API_KEY": "your_api_key_here"      }    }  }}

3. Restart Claude for Desktop to load the new configuration.

Using DeepWriter Tools with Claude

Once you've set up the MCP server, you can use DeepWriter's features directly within Claude. Here are some examples:

Listing Your Projects

To see all your DeepWriter projects, ask Claude:

Can you list all my Deepwriter projects?

Claude will use the listProjects tool to fetch and display your projects.

Creating a New Project

To create a new project, you can say:

Create a new Deepwriter project titled "My Science Fiction Novel" with my email address [email protected]

Claude will use the createProject tool to set up your new project.

Getting Project Details

To view details about a specific project:

Show me the details for my Deepwriter project with ID "proj_123456"

Claude will retrieve the project information using the getProjectDetails tool.

Updating a Project

To update an existing project:

Update my Deepwriter project "proj_123456" to change the title to "New Title" and add the following prompt: "Write a story about space explorers discovering a new planet"

Claude will use the updateProject tool to modify your project.

Generating Content

To generate content for a project:

Generate content for my Deepwriter project "proj_123456"

Claude will use the generateWork tool to create new content based on your project settings.

Deleting a Project

To delete a project:

Delete my Deepwriter project with ID "proj_123456"

Claude will confirm and then use the deleteProject tool to remove the project.

Troubleshooting

Common Issues

1. API Key Problems:

   • Ensure your DeepWriter API key is correctly set in both the .env file and Claude configuration

   • Verify the API key has not expired (remember, keys are only viewable on creation)

2. Connection Issues:

   • Check that your MCP server is running before trying to use it with Claude

   • Verify the path to your build directory is correct in the Claude configuration

3. Tool Execution Errors:

   • Double-check parameter names and formats when making requests

   • Ensure project IDs are valid when referencing existing projects

Debugging

For additional debugging information, run the server with the DEBUG environment variable:

bashDEBUG=deepwriter-mcp:* node build/index.js

You can also check Claude for Desktop logs at:

• macOS: ~/Library/Logs/Claude/mcp*.log

• Windows: %APPDATA%\Claude\logs\mcp*.log

Advanced Usage

Using Environment Variables

Instead of hardcoding your API key in the Claude configuration, you can reference environment variables:

json{  "mcpServers": {    "deepwriter": {      "command": "node",      "args": ["/path/to/deepwriter-mcp/build/index.js"],      "env": {        "DEEPWRITER_API_KEY": "${DEEPWRITER_API_KEY}"      }    }  }}

This approach allows you to manage sensitive credentials more securely.

Batch Operations

You can perform batch operations by asking Claude to execute multiple actions in sequence:

First, list all my DeepWriter projects. Then, create a new project called "Marketing Content" with my email [email protected].

Claude will execute these operations in order and provide the results of each.

Next Steps

• Explore the Deepwriter API documentation for more advanced features

• Check the GitHub repository for updates and new features

• Join the community on Discord to share tips and get help from other users