tomasz-syn-grzegorza
287c08ebfc
Consolidate connect, graph, and search workflows with mobile endpoint defaults and shared installation docs. Co-authored-by: Cursor <cursoragent@cursor.com>
96 lines
2.8 KiB
Markdown
96 lines
2.8 KiB
Markdown
---
|
||
name: gitnexus-connect
|
||
description: >-
|
||
Konfiguruje połączenie z GitNexus (MCP dla Cursora, REST/MCP dla Hermesa).
|
||
Użyj przy setupie MCP, health checku, problemach z połączeniem,
|
||
lub gdy agent nie widzi serwera gitnexus.
|
||
disable-model-invocation: true
|
||
---
|
||
|
||
# gitnexus-connect
|
||
|
||
Bootstrap połączenia z GitNexus dla **Cursor** (MCP) i **Hermes** (MCP lub REST).
|
||
|
||
## Domyślny endpoint (zdalny)
|
||
|
||
```text
|
||
https://gitnexus.mobile.agency-ai.dev/api/mcp
|
||
```
|
||
|
||
## Lokalny override (ten sam host co Docker one-gateway)
|
||
|
||
```text
|
||
http://127.0.0.1:4747/api/mcp
|
||
```
|
||
|
||
Ustaw `GITNEXUS_SERVER_URL=http://127.0.0.1:4747` gdy pracujesz lokalnie na hoście z kontenerem `one-gateway-gitnexus-server`.
|
||
|
||
## Cursor — konfiguracja MCP
|
||
|
||
Plik `~/.cursor/mcp.json`:
|
||
|
||
```json
|
||
{
|
||
"mcpServers": {
|
||
"gitnexus": {
|
||
"url": "https://gitnexus.mobile.agency-ai.dev/api/mcp"
|
||
}
|
||
}
|
||
}
|
||
```
|
||
|
||
Lokalnie zamień URL na `http://127.0.0.1:4747/api/mcp`.
|
||
|
||
Po zmianie: **Reload Window** → panel MCP → status `gitnexus` = **Connected**.
|
||
|
||
## Hermes — zmienne środowiskowe
|
||
|
||
```bash
|
||
export GITNEXUS_SERVER_URL=https://gitnexus.mobile.agency-ai.dev
|
||
export GITNEXUS_DEFAULT_REPO=one-gateway # opcjonalnie
|
||
```
|
||
|
||
Hermes może używać MCP HTTP (ten sam URL co Cursor) lub REST fallback przez skrypt z `gitnexus-search`.
|
||
|
||
## Procedura agenta
|
||
|
||
1. Uruchom health check:
|
||
|
||
```bash
|
||
bash "$SKILLS_ROOT/gitnexus-connect/scripts/gitnexus-health.sh"
|
||
```
|
||
|
||
Domyślnie `SKILLS_ROOT=$HOME/Pulpit/cursor/skills`. Możesz też podać pełną ścieżkę.
|
||
|
||
2. Sprawdź `GET /api/repos` — czy docelowe repo jest zaindeksowane (`stats.files > 0`).
|
||
3. Cursor: Reload Window → MCP panel → `gitnexus` = Connected.
|
||
4. Jeśli repo **brak na liście** — nie szukaj lokalnie. Operator musi zamontować repo na hoście GitNexus i wykonać `analyze` (szczegóły w [`reference.md`](reference.md)).
|
||
|
||
## Szybki test ręczny
|
||
|
||
```bash
|
||
curl -fsS https://gitnexus.mobile.agency-ai.dev/api/health
|
||
curl -fsS https://gitnexus.mobile.agency-ai.dev/api/repos
|
||
```
|
||
|
||
## Błędy
|
||
|
||
| Sytuacja | Akcja |
|
||
|----------|-------|
|
||
| MCP Error / timeout | Sprawdź health; użyj REST przez `gitnexus-search.py` |
|
||
| Repo nie na liście | Operator: `docker exec -w /workspace one-gateway-gitnexus-server gitnexus analyze /workspace` |
|
||
| Port 4747 zajęty lokalnie | Nie uruchamiaj drugiego `gitnexus serve` — użyj istniejącego kontenera |
|
||
| Brak auth na zdalnym URL | NPMplus Access List / Basic Auth (patrz `reference.md`) |
|
||
|
||
## Powiązane skille
|
||
|
||
| Skill | Kiedy |
|
||
|-------|-------|
|
||
| [`gitnexus-graph`](../gitnexus-graph/SKILL.md) | Architektura, zależności, impact — użyj MCP po połączeniu |
|
||
| [`gitnexus-search`](../gitnexus-search/SKILL.md) | Jawne wyszukiwanie `repo + prompt`; REST fallback |
|
||
|
||
## Referencja
|
||
|
||
- Szczegóły URL, porty, bezpieczeństwo: [`reference.md`](reference.md)
|
||
- Extended docs (one-gateway): `coding-agent/33–36*.md`
|