Canva + Roo Code: Complete MCP Integration

Canva is a MCP server that AI-powered development assistance for building Canva apps and integrations. Access Canva documentation, App UI Kit components, and Apps SDK resources directly through your AI coding assistant..

When integrated with Roo Code, you can:

• Instantly retrieve information from Canva developer documentation
• Get detailed information about Canva App UI Kit components and their usage
• Access comprehensive Apps SDK documentation and code examples

This guide provides step-by-step instructions to set up Canva in Roo Code, including configuration, examples, and troubleshooting.

What You'll Achieve

After completing this setup:

• Canva will be fully integrated and operational
• You can use Canva tools directly in Roo Code
• All Canva capabilities will be available for your workflows
• Access to 3 different tools

Prerequisites

Before starting, ensure you have:

• Node.js v20 or later installed
• npm package manager
• Git installed on your system
• Compatible MCP client (Claude Code, Cursor, Claude Desktop, or VS Code)
• Roo Code installed and configured
• Compatible operating system (Windows, macOS, Linux)

Installation

Step 1: Install Canva

Install using npm:

npx -y @canva/cli@latest mcp

Verify installation:

Ask your AI assistant about Canva App UI Kit components to verify the server is working

Configuration

Step 2: Configure Roo Code

1. Locate your configuration file:

   • Windows: %USERPROFILE%\.roo\mcp_settings.json
   • macOS: ~/.roo/mcp_settings.json
   • Linux: ~/.roo/mcp_settings.json

2. Add server configuration:

{
  "mcpServers": {
    "canva": {
      "command": "npx",
      "args": ["-y", "canva"],
      "env": {
        
      }
    }
  }
}

3. Restart Roo Code

Completely quit and restart Roo Code to load the new configuration.

Examples

Once configured, you can use Canva in Roo Code:

Query App UI Kit Components

Get information about available components in Canva App UI Kit

Ask Roo Code: "How many components are available in the Canva App UI Kit?"

Expected Result: The AI assistant will query the Canva documentation and provide the exact count and list of available components

Get Component Documentation

Retrieve detailed documentation for specific UI components

Ask Roo Code: "Show me how to use the Button component from Canva App UI Kit with examples"

Expected Result: Complete documentation including props, usage examples, and best practices for the Button component

Apps SDK Integration Help

Get assistance with integrating Canva Apps SDK features

Ask Roo Code: "How do I authenticate users in a Canva app using the Apps SDK?"

Expected Result: Step-by-step guide with code examples for implementing user authentication

Debug App Development Issues

Get help troubleshooting common Canva app development problems

Ask Roo Code: "Why is my Canva app component not rendering correctly?"

Expected Result: Diagnostic steps and common solutions based on Canva documentation and best practices

Testing Your Setup

1. Start a new conversation in Roo Code
2. Ask Roo Code to list available tools
3. Try using Canva functionality

Test prompts:

• "Type @ and verify Canva appears in the tools list"
• "Ask: "Use Canva to help with my task""
• "Check Roo Code output panel for server connection status"

Troubleshooting

Common Issues

Server not responding to Canva-related queries

Symptoms: AI assistant says it cannot find Canva documentation, Queries about App UI Kit return generic responses, No specific Canva component information provided

Cause: Server not properly installed or not loaded by the MCP client

Solution:

• Restart your IDE or MCP client completely
• Verify Node.js v20+ is installed: node --version
• Check MCP configuration includes the Canva server
• Try asking with specific keywords: "Canva App UI Kit" or "Canva Apps SDK"

Inconsistent or outdated information

Symptoms: Documentation seems outdated, Component information varies between queries, API methods mentioned do not exist

Cause: Cached responses or stale documentation

Solution:

• Start a new chat session in your AI assistant
• Ask the assistant to fetch the latest Canva documentation
• Clear any local caches if your MCP client supports it
• Verify you are using the latest @canva/cli package

Installation fails with npm errors

Symptoms: npm command returns errors, Package installation hangs or times out, Permission denied errors

Cause: npm configuration or permission issues

Solution:

• Update npm to latest version: npm install -g npm@latest
• Check Node.js version meets v20+ requirement
• Try running with explicit registry: npm config set registry https://registry.npmjs.org/
• On Windows, run terminal as administrator if permission issues occur

MCP Server Not Connecting

Symptoms: Server not appearing in tools list, Connection timeout, MCP tools unavailable

Cause: Incorrect configuration or server not starting

Solution:

• Verify mcp_settings.json syntax is correct
• Check that Node.js and npx are installed and in PATH
• View Roo Code output panel for error messages
• Test server command manually in terminal: npx -y {server_id}
• Ensure environment variables are properly set

Permission Denied Errors

Symptoms: Cannot execute commands, File access denied, Terminal commands blocked

Cause: Roo Code requires explicit permission for file and command operations

Solution:

• Review and approve permission requests when prompted
• Check VS Code workspace trust settings
• Enable necessary permissions in Roo Code settings
• Verify file and folder permissions on your system

API Key or Model Issues

Symptoms: Authentication failed, Model not responding, No AI completions

Cause: AI model API key not configured or invalid

Solution:

• Verify API key is correctly set in Roo Code settings
• Check API key has sufficient credits/quota
• Test with a different AI model provider
• Review Roo Code output panel for API error details

Custom Mode Not Working with MCP

Symptoms: MCP tools not available in custom mode, Mode cannot access server

Cause: Custom mode configuration does not include MCP tool permissions

Solution:

• Edit custom mode configuration to include MCP tools
• Add "Use MCP" to available tools in mode definition
• Ensure mode has appropriate permissions for external tools
• Test with default mode first to verify MCP server works

Extension Conflicts

Symptoms: Roo Code not responding, VS Code performance issues, Unexpected behavior

Cause: Conflicts with other AI coding extensions

Solution:

• Disable other AI coding extensions (Cline, Continue, etc.)
• Restart VS Code after disabling conflicting extensions
• Check VS Code extension logs for conflict errors
• Use only one AI coding assistant extension at a time

Canva not appearing in Roo Code

Symptoms: Server not listed, Tools not available

Cause: Configuration or installation issue

Solution:

• Verify configuration syntax
• Check Canva installation
• Restart Roo Code
• Check logs for error messages

Next Steps

Now that Canva is integrated with Roo Code:

• Explore all Canva capabilities through Roo Code
• Check out other MCP servers that work with Roo Code
• Join the MCP community for tips and support
• Consider contributing to Canva development

Need Help?

• Search for Canva documentation
• Check the Roo Code MCP guide
• Join the MCP community discussions