Tips & Tricks

Connect AppGram MCP to Your AI Coding Assistant

Learn how to connect AppGram's MCP server to Claude Code, Cursor, and other AI coding assistants for seamless content management.

What is AppGram MCP?

AppGram provides a Model Context Protocol (MCP) server that allows AI coding assistants like Claude Code and Cursor to directly manage your AppGram content. This means you can create blog posts, manage help center articles, configure surveys, and more—all without leaving your IDE.

Prerequisites

• An AppGram account with an active project

• An API key with appropriate scopes (support:* or surveys:*)

• Claude Code, Cursor, or another MCP-compatible AI assistant

Getting Your API Key

1. Log in to your AppGram dashboard

2. Navigate to Settings → API Keys

3. Click Create API Key

4. Select the scopes you need (e.g., support:* for full support access), or use provided templates.

5. Copy the generated key—it starts with ag_

Important: Store your API key securely. It won't be shown again after creation.

Connecting to Claude Code

Add the AppGram MCP server using the CLI:

claude mcp add --transport http appgram https://mcp.appgram.dev/mcp \
  --header "X-API-Key: YOUR_API_KEY"

Then restart Claude Code and verify the connection:

/mcp

You should see appgram listed as a connected server.

Configuration Options

OptionDescription--transport httpUse HTTP transport (required for remote servers)--headerAdd authentication header--scope localStore config locally (default)--scope projectStore in .mcp.json for team sharing--scope userAvailable across all projects

Connecting to Cursor

Add the following to your Cursor MCP configuration (~/.cursor/mcp.json or project-level):

{
  "mcpServers": {
    "appgram": {
      "type": "streamableHttp",
      "url": "https://mcp.appgram.dev/mcp",
      "headers": {
        "X-API-Key": "YOUR_API_KEY"
      }
    }
  }
}

Authentication Methods

AppGram MCP supports two authentication headers:

X-API-Key

X-API-Key: ag_your-api-key-here

Available Tools

Once connected, you'll have access to these tool categories:

Projects

• list_projects — List accessible projects

Blog

• list_blog_posts, create_blog_post, update_blog_post, delete_blog_post

• list_blog_categories, create_blog_category

• search_blog_posts, get_all_blog_tags

Help Center

• help_center_list_collections, help_center_create_collection

• help_center_list_flows, help_center_create_flow

• help_center_list_articles, help_center_create_article

Surveys

• list_surveys, create_survey, update_survey

• list_survey_nodes, create_survey_node

• list_survey_responses

Forms

• list_forms, create_form, update_form

• list_support_forms, create_support_form

Project-Scoped API Keys

API keys can be scoped to a specific project. When using a project-scoped key:

• The list_projects tool returns only that project

• All operations are automatically scoped to that project

• This is ideal for CI/CD pipelines or dedicated integrations

Troubleshooting

"Invalid or expired API key"

• Verify the key starts with ag_

• Check for typos—API keys are long UUIDs

• Ensure the key hasn't been revoked in the dashboard

"Authentication required"

• Confirm the header is being sent correctly

• Try using X-API-Key instead of Authorization: Bearer

• Restart your AI assistant after configuration changes

Connection Fails

• Verify the URL is https://mcp.appgram.dev/mcp

• Check your network/firewall settings

• Test with curl: curl -X POST https://mcp.appgram.dev/mcp -H "X-API-Key: YOUR_KEY" -H "Content-Type: application/json" -d '{"jsonrpc":"2.0","id":1,"method":"initialize","params":{"protocolVersion":"2024-11-05","capabilities":{},"clientInfo":{"name":"test","version":"1.0"}}}'

Example Usage

Once connected, you can ask your AI assistant things like:

• "List all blog posts in my project"

• "Create a new blog post about our latest feature"

• "Add a FAQ article to the help center"

• "Show me survey responses from last week"

The AI will use the appropriate MCP tools to fulfill your request, making content management seamless and integrated into your development workflow.