Skip to main content

Apper MCP Connector

Model Context Protocol · Streamable HTTP

Build Apper apps from ChatGPT or Claude​

Connect Apper to ChatGPT or Claude and build complete applications through simple chat.

Describe the app you want in plain English. Your AI assistant uses Apper to create it, show you a working preview, add features, connect a database when needed, and make changes to your app directly from the conversation.

You do not need to understand MCP or write code to get started.

Serverhttps://mcp.apper.io/v1.1/connect
TransportStreamable HTTP
AuthenticationOAuth 2.0

How it works​

Apper connects to ChatGPT, Claude, or other AI/LLM models through the Model Context Protocol (MCP).

Once connected, your AI assistant can use Apper to create and update apps inside your Apper account. You can keep giving instructions in plain English while Apper handles the app infrastructure behind the scenes.

  • Describe your app — Tell your AI assistant what you want to build.
    create_app
    Apper creates the first version of your app, using sample data when needed.
  • Preview it — Once the app is built, open a working preview and try it yourself.
    get_build_status → preview_app
  • Make changes — Ask for new pages, features, design changes, or fixes. Apper can read and update your project files as needed, then rebuild the app and give you a fresh preview.
  • Connect a database when needed — If your app needs real users, saved records, or persistent data, you can connect it to a real database.
    connect_database

    info

    Database changes: After connecting, Apper uses create_database_components to add new tables, fields, access rules, profiles, and permissions; update_database_components to change existing ones; and delete_database_components to remove them. Deleting a table removes its data.

  • Keep building — Once connected, you can keep changing your app, database structure, permissions, server-side functions, configuration, features, and design through the conversation.
caution

Switching from sample data to a connected database is a one-time change and cannot be reversed.


Available tools​

Your AI assistant automatically selects the right Apper tools based on what you ask.

  • Read-only tools can view information but cannot change anything.
  • Write tools can create, update, or delete something in your app.

Apps and project files​

ToolTypeWhat it does
search_appsRead-onlyFind an existing app or list your apps.
create_appWriteStart a new app from your description.
get_create_app_instructionsRead-onlyProvides instructions for creating an Apper app correctly.
get_edit_app_instructionsRead-onlyProvides instructions for editing an existing app.
get_design_directivesRead-onlyProvides product and design guidance for building your app.
get_project_treeRead-onlyView the files and folders in an existing app.
read_filesRead-onlyRead app files before making changes.
write_filesWriteCreate or update files in your app. Replaces a file's full contents.
patch_filesWriteMake small edits to part of an existing file without rewriting the whole file. The edited text is replaced in place.
apply_patchWriteApply a unified diff (git-diff format) to existing files. Rewrites the matched sections of the file in place.
delete_filesWriteRemove files from your app.

Build and preview​

ToolTypeWhat it does
get_build_statusRead-onlyCheck whether your latest app changes have finished building.
preview_appRead-onlyOpen a live preview of your app.

Database​

ToolTypeWhat it does
get_backend_schemaRead-onlyView your app's current database structure.
get_backend_schema_filteredRead-onlyView specific parts of your database structure.
connect_databaseWriteSwitch your app from sample data to a connected database. This is a one-time change and cannot be reversed.
create_database_componentsWriteAdds tables, fields, access rules, profiles, and permissions. It never changes existing ones.
update_database_componentsWriteChanges existing tables, fields, access rules, profiles, and permissions.
delete_database_componentsWriteRemoves tables, fields, access rules, profiles, and permissions. Deleting a table removes its data.
get_rls_policy_instructionsRead-onlyProvides instructions for setting up database access rules correctly.

Server-side functions​

Server-side functions let your app securely handle tasks such as sending emails, processing payments, or calling external APIs.

ToolTypeWhat it does
create_edge_functionWriteCreate new server-side functionality.
get_edge_functionRead-onlyView an existing server-side function.
update_edge_functionWriteChange an existing server-side function.
delete_edge_functionWriteRemove a server-side function.
list_edge_functionsRead-onlyList the server-side functions in your app.

Secrets and configuration​

ToolTypeWhat it does
create_secretsWriteRegister a secret such as an API key. You enter the actual value securely in Apper.
list_secretsRead-onlySee which secrets have been added without revealing their values.
delete_secretWriteRemove a secret from your app.
get_env_keysRead-onlyView your app's public configuration keys.
set_env_keyWriteAdd or change a public configuration value.

Session​

ToolTypeWhat it does
generate_message_idWriteRecords your message in the app's history and returns an id used to group the actions taken for it.

Connector​

ToolTypeWhat it does
check_mcp_versionRead-onlyCheck whether the Apper MCP connector is up to date.

Data and Security​

Your secret values stay private​

No need to worry — sharing an API key can feel risky, so here's exactly how we keep yours secure.

Secret values such as API keys are entered directly in Apper — never shared in chat with your AI assistant.

How it works:

  • When you want to enter your secret API key, open Apper's Secrets page and add it there — it's safely stored in an encrypted vault, never in a chat window.
  • Your AI assistant only ever sees the key's name (like OPENAI_API_KEY), never the actual value.
  • The real key is used securely behind the scenes only when your app runs.

For example, you can create a secret called:

OPENAI_API_KEY

Your AI assistant can then build functionality that uses it — without ever seeing the key itself.

tip

Simple rule: Add your keys in Apper's Secrets page, not in the chat.

Database connection is permanent​

Connecting an app to a real database is a one-time change.

Once connected, the app cannot be switched back to sample data.

tip

Make sure you are happy with the basic app before approving the database connection.


Support​

Questions, issues, or feedback: [email protected]

Privacy policy: https://integrately.com/home/privacy