Installation

Only EDT 2026.1+ (for plugin v1.27.0+; use plugin v1.26.1 for EDT 2025.x)

From Update Site

1. In EDT: Help → Install New Software...
2. Add update site URL: https://ditrixnew.github.io/EDT-MCP/
3. Select EDT MCP Server Feature
4. Restart EDT

From Windows command line - "one shot" very fast install

Close your EDT (!) and run:

rem Here  "%VER_EDT% = 2025.2.3+30"  just for example - please, set YOUR actual version !
set VER_EDT=2025.2.3+30

"\your\path\to\EDT\components\1c-edt-%VER_EDT%-x86_64\1cedt.exe" -nosplash ^
    -application org.eclipse.equinox.p2.director ^
    -repository https://ditrixnew.github.io/EDT-MCP/ ^
	-installIU com.ditrix.edt.mcp.server.feature.feature.group ^
	-profileProperties org.eclipse.update.reconcile=true

Installation Result

After that, EDT will automatically monitor the update site and install available updates when detected.

As well, we can also manually check via Help → About → Installation Details → Select MCP → Update

Configuration

Go to Window → Preferences → MCP Server:

• Server Port: HTTP port (default: 8765)
• Check descriptions folder: Path to check description markdown files
• Auto-start: Start server on EDT launch
• Default result limit: Default number of results returned by tools (default: 100)
• Maximum result limit: Maximum number of results that can be requested (default: 1000)
• Plain text mode (Cursor compatibility): Returns results as plain text instead of embedded resources (for AI clients that don't support MCP resources)
• Show tags in Navigator: Display tags as decorations in the Navigator tree
• Tag decoration style: How tags are displayed — all tags as suffix, first tag only, or tag count

Status Bar Controls

The MCP server status bar shows real-time execution status with interactive controls.

Status Indicator:

• 🟢 Green - Server running, idle
• 🟡 Yellow blinking - Tool is executing
• ⚪ Grey - Server stopped

During Tool Execution:

• Shows tool name (e.g., MCP: update_database)
• Shows elapsed time in MM:SS format
• Click to access control menu

When a tool is executing, you can send signals to the AI agent to interrupt the MCP call:

| Button | Description | When to Use | |--------|-------------|-------------| | Cancel Operation | Stops the MCP call and notifies agent | When you want to cancel a long-running operation | | Retry | Tells agent to retry the operation | When an EDT error occurred and you want to try again | | Continue in Background | Notifies agent the operation is long-running | When you want agent to check status periodically | | Ask Expert | Stops and asks agent to consult with you | When you need to provide guidance | | Send Custom Message... | Send a custom message to agent | For any custom instruction |

How it works:

1. When you click a button, a dialog appears showing the message that will be sent to the agent
2. You can edit the message before sending
3. The MCP call is immediately interrupted and returns control to the agent
4. The EDT operation continues running in the background
5. Agent receives a response like:

USER SIGNAL: Your message here

Signal Type: CANCEL
Tool: update_database
Elapsed: 20s

Note: The EDT operation may still be running in background.

Use cases:

• Long-running operations (full database update, project validation) blocking the agent
• Need to give the agent additional instructions
• EDT showed an error dialog and you want agent to retry
• Want to switch agent's focus to a different task

Connecting AI Assistants

VS Code / GitHub Copilot

Create .vscode/mcp.json:

{
  "servers": {
    "EDT MCP Server": {
      "type": "sse",
      "url": "http://localhost:8765/mcp"
    }
  }
}

Cursor IDE

Note: Cursor doesn't support MCP embedded resources. Enable "Plain text mode (Cursor compatibility)" in EDT preferences: Window → Preferences → MCP Server.

Create .cursor/mcp.json:

{
  "mcpServers": {
    "EDT MCP Server": {
      "url": "http://localhost:8765/mcp"
    }
  }
}

Claude Code

Note: By editing the file .claude.json can be added to the MCP either to a specific project or to any project (at the root). If there is no mcpServers section, add it.

Add to .claude.json (in Windows %USERPROFILE%\.claude.json):

"mcpServers": {
  "EDT MCP Server": {
    "type": "http",
    "url": "http://localhost:8765/mcp"
  }
}

Claude Desktop

Add to claude_desktop_config.json:

{
  "mcpServers": {
    "EDT MCP Server": {
      "url": "http://localhost:8765/mcp"
    }
  }
}

Cline - extension for VSCode.

{
  "mcpServers": {
    "EDTMCPServer": {
      "type": "streamableHttp",
      "url": "http://localhost:8765/mcp"
    }
  }
}

Available Tools

| Tool | Description | |------|-------------| | get_edt_version | Returns current EDT version | | list_projects | Lists workspace projects with properties | | get_configuration_properties | Gets 1C configuration properties | | get_project_errors | Returns EDT problems with severity/checkId/objects filters | | get_problem_summary | Problem counts grouped by project and severity | | clean_project | Cleans project markers and triggers full revalidation | | revalidate_objects | Revalidates specific objects by FQN (e.g. "Document.MyDoc") | | get_bookmarks | Returns workspace bookmarks | | get_tasks | Returns TODO/FIXME task markers | | get_check_description | Returns check documentation from .md files | | get_content_assist | Get content assist proposals (type info, method hints) | | get_platform_documentation | Get platform type documentation (methods, properties, constructors) | | get_metadata_objects | Get list of metadata objects from 1C configuration | | get_metadata_details | Get detailed properties of metadata objects (attributes, tabular sections, etc.) | | find_references | Find all references to a metadata object (in metadata, BSL code, forms, roles, etc.) — top-level objects only | | rename_metadata_object | Rename a metadata object or attribute with full refactoring: cascading updates in BSL code, forms, and metadata. Preview + confirm workflow | | delete_metadata_object | Delete a metadata object or attribute with reference cleanup. Preview + confirm workflow | | add_metadata_attribute | Add a new attribute to a metadata object (Catalog, Document, Register, etc.) | | get_tags | Get list of all tags defined in the project with descriptions and object counts | | get_objects_by_tags | Get metadata objects filtered by tags with tag descriptions and object FQNs | | get_applications | Get list of applications (infobases) for a project with update state | | update_database | Update database (infobase) with full or incremental update mode | | debug_launch | Launch application in debug mode (auto-updates database before launch) | | run_yaxunit_tests | Run YAXUnit tests for a project: launches 1C with RunUnitTests, parses JUnit XML, returns Markdown report | | get_form_screenshot | Capture PNG screenshot of form WYSIWYG editor (embedded image resource) | | list_modules | List all BSL modules in a project with module type a