diff --git a/README.md b/README.md index 09c377e..c3fc7ff 100644 --- a/README.md +++ b/README.md @@ -23,34 +23,37 @@ business logic — no feature gap between them: > Ask *"Is table MARA available in ABAP Cloud?"* and the agent instantly knows: > **no — use `I_PRODUCT` instead.** -## Quick start — Hosted instance (recommended) +## Quick start -ROSA is publicly hosted — no install, no server to run. Connect your AI agent -directly: +> **The previously hosted public instance (on Railway) has been retired** — it +> was too costly to keep running. There is **no default public URL** anymore. +> Everything else still works: run ROSA via `npx`, a native executable, Docker, +> any Node host, or SAP BTP — see the deployment options below. -### MCP (Claude Desktop, Claude Code, Cursor, Cline…) - -**Claude Code** (`.mcp.json`) / **Claude Desktop** (`claude_desktop_config.json`): +The quickest path is **npx** — no install, runs in stdio mode (what MCP clients +expect). Add this to your client config (Claude Code `.mcp.json`, Claude Desktop +`claude_desktop_config.json`, or Cursor `~/.cursor/mcp.json`): ```json { "mcpServers": { "rosa": { - "type": "url", - "url": "https://sap-released-objects-server-production.up.railway.app/mcp" + "command": "npx", + "args": ["-y", "@rosa-mcp/server"] } } } ``` -**Cursor** (`~/.cursor/mcp.json` or `.cursor/mcp.json`): +Already running ROSA somewhere (self-hosted / your own server)? Point your client +at its URL instead: ```json { "mcpServers": { "rosa": { "type": "url", - "url": "https://sap-released-objects-server-production.up.railway.app/mcp" + "url": "https:///mcp" } } } @@ -58,18 +61,20 @@ directly: ### REST API -All endpoints are `GET`, return JSON, and support CORS: +All endpoints are `GET`, return JSON, and support CORS (replace `` +with your own host): ```bash -curl "https://sap-released-objects-server-production.up.railway.app/api/search?query=purchase+order" -curl "https://sap-released-objects-server-production.up.railway.app/api/object?object_type=TABL&object_name=MARA" -curl "https://sap-released-objects-server-production.up.railway.app/api/compliance?object_names=MARA,BSEG,I_PRODUCT" +curl "https:///api/search?query=purchase+order" +curl "https:///api/object?object_type=TABL&object_name=MARA" +curl "https:///api/compliance?object_names=MARA,BSEG,I_PRODUCT" ``` -For LLM-skill usage, two ready-made skills expose the full API reference: +For LLM-skill usage, the full API reference is available as a skill you point at +your instance: -- [`skills/sap-released-objects/SKILL.md`](./skills/sap-released-objects/SKILL.md) — points at the hosted public instance; use as-is. -- [`skills/rosa-global/SKILL.md`](./skills/rosa-global/SKILL.md) — for your **own self-hosted** deployment: copy it and replace the `{{ROSA_BASE_URL}}` placeholder with your instance URL. +- [`skills/rosa-global/SKILL.md`](./skills/rosa-global/SKILL.md) — copy it and replace the `{{ROSA_BASE_URL}}` placeholder with your instance URL. +- [`skills/sap-released-objects/SKILL.md`](./skills/sap-released-objects/SKILL.md) — **obsolete** (was wired to the retired hosted instance); kept for reference only. --- diff --git a/skills/sap-released-objects/SKILL.md b/skills/sap-released-objects/SKILL.md index 8346582..3743587 100644 --- a/skills/sap-released-objects/SKILL.md +++ b/skills/sap-released-objects/SKILL.md @@ -1,16 +1,23 @@ --- -name: ROSA — Released Objects Search Assistant -description: This API queries the SAP Cloudification Repository — the official source of truth for which SAP objects are released, deprecated, or forbidden in ABAP Cloud / Clean Core. It answers questions regarding object status, successors (e.g., MARA → I_PRODUCT), and Clean Core compliance. +name: ROSA — Released Objects Search Assistant (OBSOLETE) +description: "[OBSOLETE — the hosted instance this skill targeted has been retired; use skills/rosa-global instead.] This API queries the SAP Cloudification Repository — the official source of truth for which SAP objects are released, deprecated, or forbidden in ABAP Cloud / Clean Core. It answers questions regarding object status, successors (e.g., MARA → I_PRODUCT), and Clean Core compliance." --- # Skill Instructions +> ⚠️ **OBSOLETE — do not use as-is.** The hosted instance this skill targeted (on +> Railway) has been retired, so the base URL below no longer responds. Kept for +> reference only. Use [`../rosa-global/SKILL.md`](../rosa-global/SKILL.md) +> instead and set your own `{{ROSA_BASE_URL}}`. + ## Base URL ``` https://sap-released-objects-server-production.up.railway.app ``` +> This endpoint is no longer available (see the obsolete notice above). + All endpoints return JSON. All parameters are passed as query string. All endpoints support CORS. ## Common Parameters