1c-rest-mcp — Claude Code MCP server: setup
Connects an AI agent to live 1C data through OData 3.0. It can read and change catalogs, documents, registers, and metadata.
claude mcp add 1c-rest-mcp -- npx -y @theyahia/1c-rest-mcpWhat 1c-rest-mcp does
1c-rest-mcp gives an agent access to a live 1C Enterprise database through the platform’s OData 3.0 endpoint. It covers catalogs, documents, registers, constants, batch actions, change tracking, and metadata discovery. Write operations are supported too.
A write gate can run in off, preview, or approval mode, while reversible actions return a rollback token. The server runs with npx and uses ONEC_BASE_URL, ONEC_LOGIN, and ONEC_PASSWORD for the connection. The 1C OData endpoint must be published, or the server cannot reach the database.
What it helps with
- read records from 1C catalogs
- create or update 1C documents
- inspect register balances and turnovers
- discover entities and links from metadata
- run batch actions against the database
Example prompts for the agent
- Use the connected MCP server to show records from a 1C catalog.
- Create a 1C document, but ask for approval before writing it.
- Find the relevant register metadata and report its balances and turnovers.
How to install 1c-rest-mcp
Platform CLI
claude mcp add 1c-rest-mcp -- npx -y @theyahia/1c-rest-mcpPlatform CLI
codex mcp add 1c-rest-mcp -- npx -y @theyahia/1c-rest-mcpConfig file
{
"mcpServers": {
"1c-rest-mcp": {
"command": "npx",
"args": [
"-y",
"@theyahia/1c-rest-mcp"
]
}
}
}Config file
{
"servers": {
"1c-rest-mcp": {
"type": "stdio",
"command": "npx",
"args": [
"-y",
"@theyahia/1c-rest-mcp"
]
}
}
}Platform CLI
gemini mcp add 1c-rest-mcp npx -y @theyahia/1c-rest-mcpStep by step, with commands for each platform: How to add an MCP server to Claude Code, Codex, Cursor, VS Code, Gemini CLI and more
Questions about 1c-rest-mcp
How do I install 1c-rest-mcp in Claude Code?
Run claude mcp add 1c-rest-mcp -- npx -y @theyahia/1c-rest-mcp.
What does 1c-rest-mcp do?
It connects an AI agent to 1C Enterprise through OData 3.0. The server supports database reads and writes across catalogs, documents, registers, constants, and metadata.
What does 1c-rest-mcp need to connect?
The 1C OData endpoint must be published. Set ONEC_BASE_URL, ONEC_LOGIN, and ONEC_PASSWORD; ONEC_WRITE_MODE controls the write gate.
