Steps to setup and run IdeaScale's MCP server
Introducing the IdeaScale MCP Server!
Our very own MCP feature is here to make securely accessing community data easier than ever using LLM. With simple question prompts to the chatbot, you can instantly retrieve information on ideas, campaigns, funnels, stages, labels, and members—streamlining insights and saving valuable time.
This feature ensures secure member access through the use of API keys and service tokens. The data that can be retrieved is in line with the existing roles and permissions assigned within IdeaScale.
This MCP server is compatible with various LLM clients, including Claude and Cursor IDE.
IdeaScale MCP Server with Claude
IdeaScale MCP Server with Cursor IDE
IdeaScale MCP server with Claude
Follow the given steps to setup IdeaScale MCP server with Claude:
1. To begin, download and install the Claude desktop application from https://claude.ai/download and Node.js from https://nodejs.org/en/download.
2. Once installed, sign up or log in to the Claude application and navigate to Settings >> Developer.
3. Select the Edit Config button to locate and open the configuration file for editing.
4. Please input the following code, that can be found under your IdeaScale Profile >> Settings >> MCP Servers >> Configuration for Claude Desktop. Ensure that you replace the [WORKSPACE_URL] with your specific Workspace URL followed by /mcp (Example: https://ideas.ideascale.com/mcp). Additionally, substitute the [COMMUNITY_API_TOKEN] with the appropriate API token for your community, accessible from IdeaScale Profile >> Settings >> API Tokens (Example: 91d465cf-08b0-4c74-be3f-1539e512925e). For further assistance, please refer to the help article on API tokens.
{
"mcpServers": {
"ideascale-mcp": {
"command": "npx",
"args": [
"-y",
"mcp-remote",
"https://[WORKSPACE_URL]/mcp",
"--header",
"api_token:[COMMUNITY_API_TOKEN]"
]
}
}
}
5. Upon completing the modifications, please save the file, then exit the Claude application and reopen it to initiate the MCP server. You may remove the configuration by selecting the Recycle Bin/Trashcan icon.
6. You are now ready to begin utilizing the MCP server for your community data access needs.
Once you have completed the setup, navigate to the chat section to start interacting with the MCP server.
At the moment, the server supports GET API calls to retrieve the following data: Active campaigns, Archived campaigns, Funnels, Stages, Members, Search ideas, Draft ideas, Followed ideas, All comments, Specific idea comments, Pending comments, Labels, My profile and Votes
You can enable or disable these data options through the Tuning icon located under the text field.
A visual representation of the data can also be generated.
In the following example, the system was prompted to produce a chart displaying the number of kudos received by members. The data was provided in both textual format and a variety of visual formats - Bar chart, Pie chart, Summary statistics, Detailed table and Key insights for enhanced clarity and analysis.
IdeaScale MCP server with Cursor IDE
Follow the given steps to setup IdeaScale MCP server with Claude:
1. To begin, download and install the Cursor IDE desktop application from https://cursor.com/downloads or go to Cursor IDE https://cursor.com/
2. Sign up or log in to the Cursor application and navigate to Settings >> Tools & Integrations >> MCP Tools.
3. Click on + sign of New MCP Tool to navigate to the JSON field and input the following code that can be found under your IdeaScale Profile >> Settings >> MCP Servers >> Configuration of Cursor IDE. Ensure that you replace the [WORKSPACE_URL] with your specific Workspace URL followed by /mcp (Example: https://ideas.ideascale.com/mcp). Additionally, substitute the [COMMUNITY_API_TOKEN] with the appropriate API token for your community, accessible from IdeaScale Profile >> Settings >> API Tokens (Example: 91d465cf-08b0-4c74-be3f-1539e512925e). For further assistance, please refer to the help article on API tokens.
{
"mcpServers": {
"ideascale-mcp": {
"url": "https://[WORKSPACE_URL]/mcp",
"headers": {
"api_token": "[COMMUNITY_API_TOKEN]"
}
}
}
}
4. After adding the code, it will be visible under MCP Tools. You may enable/disable the configuration as well.
6. You are now ready to begin utilizing the MCP tool for your community data access needs.
Once you have completed the setup, navigate to the chat section to start interacting with the MCP server.