MCP Native

Integrate KatappultAI into your IDE

KatappultAI exposes a full MCP server — 28 structured, secure and documented tools. Drive your application from Claude Code, Cursor, Windsurf or any compatible MCP client.

28 toolsnative MCP

4 clientscompatible

SSEnative

Prerequisites — Get an API token

Create a KatappultAI account

Go to platform.katappult.ai and create your account.

Generate an API token

Settings → Security → API Tokens → Generate new token. Copy it — it will only be shown once.

Configure your client

Add the URL and token to your MCP client (see the guides below).

MCP server URLhttps://platform.katappult.ai/mcp/sse

TransportSSE (Server-Sent Events)

AuthenticationAuthorization: Bearer <YOUR_TOKEN>

Integration guides by client

Step-by-step configuration for each MCP-compatible AI tool

terminal

claude mcp add --transport http katappultAi \
  https://api.katappult.ai/mcp \
  --header "Authorization: Bearer VOTRE_TOKEN_API"

Verification

Type /mcp in a Claude Code session to verify that katappultAi is active with at least 28 tools.

28 MCP tools — Complete reference

KatappultAI exposes 28 tools organized into 3 categories

Projects7 tools

Most modification operations require calling checkout_project first.

list_projects	Lists your projects with pagination
get_project	Project details
create_project	Creates a new project
checkout_project	Switches a project to edit mode
rename_project	Renames a project
archive_project	Archives a project (soft delete)
delete_project	Permanently deletes a project

Data model18 tools

get_project_model	Full JSON model of the project
list_entities	Lists entity names in the model
get_entity	Full configuration of an entity
get_generator_config	Generator configuration
add_or_update_entity	Adds or replaces a complete entity
delete_entity	Deletes an entity from the model
update_generator_config	Updates the generator configuration
add_attribute	Adds an attribute to an entity
remove_attribute	Removes an attribute
update_attribute_required	Updates the required status of an attribute
add_relation	Creates a relation (oneToMany, oneToOne, manyToMany)
remove_relation	Removes a relation
list_available_features	Lists all available features (Knoers)
add_feature	Activates a feature on an entity
remove_feature	Deactivates a feature
add_business_type	Adds a business type to an entity
remove_business_type	Removes a business type
apply_changes	Applies multiple changes in a single atomic transaction

Workflows3 tools

get_entity_workflow	Retrieves the workflow of a LifecycleManaged entity
update_entity_workflow	Updates an entity's workflow
reset_entity_workflow	Resets the workflow to its default state

Workflow examples

What you can accomplish with a single natural language sentence

E-commerce model from scratch

Your prompt

“Create an 'E-Commerce' project and model a product catalog with Product (name, price, description, stock), Category (name), and a manyToMany relation between Product and Category. Add the Numberable feature on Product.”

Automatic tool sequence

1create_project → gets the internalId
2checkout_project
3add_attribute × 4 on Product + × 1 on Category
4add_relation (Product ↔ Category, manyToMany)
5add_feature (Numberable on Product)

Order lifecycle

Your prompt

“In the 'E-Commerce' project, add the LifecycleManaged feature to the Order entity, then modify the workflow: Cart → Ordered → Paid → In preparation → Shipped → Delivered.”

Automatic tool sequence

1checkout_project
2add_feature (LifecycleManaged on Order)
3get_entity_workflow (read existing state)
4update_entity_workflow (apply new states)

Inspection and refactoring

Your prompt

“List the entities in the 'CRM-App' project, show me the Contact entity details, then rename the 'phone' attribute to 'phoneNumber' and add an optional 'linkedInUrl' attribute of type String.”

Automatic tool sequence

1list_entities
2get_entity (Contact)
3apply_changes (removeAttribute + addAttribute — atomic transaction)

Security & Best practices

API token protection

Never commit your API token to Git. Use a KATAPPULT_TOKEN environment variable.

# ❌ Never do this git add ~/.claude.json # ✅ Best practice export KATAPPULT_TOKEN="votre_token"

Data isolation

Each token is strictly isolated. You can only access your own projects. Immediately revoke a compromised token from Settings → Security → API Tokens.

Irreversible operations

⚠delete_project — Irreversible. Recommend get_project_model beforehand.
⚠delete_entity — Irreversible. Save the model first.
↩archive_project — Reversible from the interface.

Troubleshooting

Tool not found in IDE

Claude Code: type /mcp to list servers. Cursor: Settings → MCP → check server status. Windsurf: Settings → MCP Servers → check toggle.

SSE Timeout

If the SSE connection drops after inactivity, your MCP client reconnects automatically. This behavior is normal.