MCP

1. Overview
2. Where to find the MCP
3. How to use the MCP

1. Overview

The TALY MCP (Model Context Protocol) server provides a set of tools that guides AI Agents in modifying specific TALY features (e.g., Dynamic Form). Tool selection is automatic and handled by the client (e.g., GitHub Copilot), not by the server authors.

Clients (AI agents) are responsible for reading and updating the files. Clients like GitHub Copilot can call multiple tools sequentially and retry if generated snippets are incorrect (e.g., violating the JSON schema).

2. Where to find the MCP

The TALY MCP is shipped as part of the @allianz/taly-core library starting from version 47.4.0

3. How to use the MCP

3.1. Automatic configuration setup with VS Code

Install the MCP server by running the command below from the workspace root folder.

This will automatically create or update the .vscode/mcp.json file in your project root, adding the necessary MCP server configuration.

npx --no-install taly-add-mcp-server

3.2. Manual configuration setup

You can also configure the MCP manually by adding or updating the MCP JSON configuration.

The exact location changes depending on the IDE (e.g., .vscode/mcp.json for VS Code)

"servers": {
    "taly-mcp-server": {
        "command": "node",
        "type": "stdio",
        "args": [
            "./node_modules/@allianz/taly-core/mcp/src/index.js"
        ]
    }
}

3.3. Start the MCP server

The exact procedure changes depending on the IDE.

In VS Code this can be done by opening the mcp.json in the .vscode folder. An inline button to start the server should appear on the file after a few seconds. Click "Start."

3.4. Verify the MCP server status

Open your preferred coding assistant and make sure that the MCP server is activated.

For example: if you are using Github Copilot, switch to the "Agent" mode (the default mode should be "Ask") and click on the "Configure tools" button to ensure that the TALY MCP server is activated.

3.5. Insert a prompt

You can now prompt the agent.

For example: Modify the dynamic form of the playground app to add a mandatory nickname field.

MCP