mcp-nextcloud/charts/nextcloud-mcp-server/templates/NOTES.txt

Thank you for installing {{ .Chart.Name }}!

Your Nextcloud MCP Server has been deployed in {{ .Values.auth.mode }} authentication mode.

1. Get the application URL by running these commands:
{{- if .Values.ingress.enabled }}
{{- range $host := .Values.ingress.hosts }}
  {{- range .paths }}
  http{{ if $.Values.ingress.tls }}s{{ end }}://{{ $host.host }}{{ .path }}
  {{- end }}
{{- end }}
{{- else if contains "NodePort" .Values.service.type }}
  export NODE_PORT=$(kubectl get --namespace {{ .Release.Namespace }} -o jsonpath="{.spec.ports[0].nodePort}" services {{ include "nextcloud-mcp-server.fullname" . }})
  export NODE_IP=$(kubectl get nodes --namespace {{ .Release.Namespace }} -o jsonpath="{.items[0].status.addresses[0].address}")
  echo http://$NODE_IP:$NODE_PORT
{{- else if contains "LoadBalancer" .Values.service.type }}
     NOTE: It may take a few minutes for the LoadBalancer IP to be available.
           You can watch the status of by running 'kubectl get --namespace {{ .Release.Namespace }} svc -w {{ include "nextcloud-mcp-server.fullname" . }}'
  export SERVICE_IP=$(kubectl get svc --namespace {{ .Release.Namespace }} {{ include "nextcloud-mcp-server.fullname" . }} --template "{{"{{ range (index .status.loadBalancer.ingress 0) }}{{.}}{{ end }}"}}")
  echo http://$SERVICE_IP:{{ .Values.service.port }}
{{- else if contains "ClusterIP" .Values.service.type }}
  export POD_NAME=$(kubectl get pods --namespace {{ .Release.Namespace }} -l "app.kubernetes.io/name={{ include "nextcloud-mcp-server.name" . }},app.kubernetes.io/instance={{ .Release.Name }}" -o jsonpath="{.items[0].metadata.name}")
  export CONTAINER_PORT=$(kubectl get pod --namespace {{ .Release.Namespace }} $POD_NAME -o jsonpath="{.spec.containers[0].ports[0].containerPort}")
  echo "Visit http://127.0.0.1:8080 to use your MCP server"
  kubectl --namespace {{ .Release.Namespace }} port-forward $POD_NAME 8080:$CONTAINER_PORT
{{- end }}

2. Check the deployment status:
  kubectl --namespace {{ .Release.Namespace }} get pods -l "app.kubernetes.io/name={{ include "nextcloud-mcp-server.name" . }},app.kubernetes.io/instance={{ .Release.Name }}"

{{- if eq .Values.auth.mode "basic" }}

3. Basic Authentication Mode:
   {{- if .Values.auth.basic.existingSecret }}
   - Credentials: (using existing secret {{ .Values.auth.basic.existingSecret }})
   {{- else }}
   - Username: {{ .Values.auth.basic.username }}
   - Password: (stored in secret {{ include "nextcloud-mcp-server.basicAuthSecretName" . }})
   {{- end }}
   - Connected to: {{ .Values.nextcloud.host }}
{{- else if eq .Values.auth.mode "oauth" }}

3. OAuth Authentication Mode:
   - Server URL: {{ include "nextcloud-mcp-server.mcpServerUrl" . }}
   - Issuer URL: {{ include "nextcloud-mcp-server.publicIssuerUrl" . }}
   - Connected to: {{ .Values.nextcloud.host }}
   {{- if .Values.auth.oauth.existingSecret }}
   - Using existing OAuth client secret: {{ .Values.auth.oauth.existingSecret }}
   {{- else if and .Values.auth.oauth.clientId .Values.auth.oauth.clientSecret }}
   - Using pre-registered OAuth client
   {{- else }}
   - Using Dynamic Client Registration (DCR)
   {{- end }}
   {{- if .Values.auth.oauth.persistence.enabled }}
   - OAuth client credentials are persisted in PVC: {{ include "nextcloud-mcp-server.oauthPvcName" . }}
   {{- end }}

   IMPORTANT: OAuth mode is experimental and requires patches to the user_oidc app.
   See: https://github.com/cbcoutinho/nextcloud-mcp-server#authentication
{{- else if eq .Values.auth.mode "multi-user-basic" }}

3. Multi-User BasicAuth Mode (Pass-Through):
   - Users provide credentials via Authorization header
   - Connected to: {{ .Values.nextcloud.host }}
   {{- if .Values.auth.multiUserBasic.enableOfflineAccess }}
   - Offline access: Enabled (background operations with app passwords)
   - Token storage: {{ .Values.auth.multiUserBasic.tokenStorageDb }}
   {{- else }}
   - Offline access: Disabled (stateless pass-through)
   {{- end }}
{{- else if eq .Values.auth.mode "login-flow" }}

3. Login Flow v2 Mode (Experimental, ADR-022):
   - Server URL: {{ include "nextcloud-mcp-server.mcpServerUrl" . }}
   - Connected to: {{ .Values.nextcloud.host }}
   - Token storage: {{ .Values.auth.loginFlow.tokenStorageDb }}

   Users authenticate via Nextcloud's native Login Flow v2 — no OAuth patches required.
   Each user gets a per-device app password managed by the MCP server.

   IMPORTANT: Login Flow v2 is experimental. See ADR-022 for details.
{{- end }}

{{- if .Values.documentProcessing.enabled }}

4. Document Processing:
   - Enabled: {{ .Values.documentProcessing.enabled }}
   - Default processor: {{ .Values.documentProcessing.defaultProcessor }}
   {{- if .Values.documentProcessing.unstructured.enabled }}
   - Unstructured API: {{ .Values.documentProcessing.unstructured.apiUrl }}
   {{- end }}
{{- end }}

{{- if .Values.semanticSearch.enabled }}

5. Semantic Search & Vector Capabilities:
   - Semantic Search: Enabled
   - Scan Interval: {{ .Values.semanticSearch.scanInterval }}s
   - Processor Workers: {{ .Values.semanticSearch.processorWorkers }}
   {{- if .Values.qdrant.enabled }}
   - Qdrant: Deployed as subchart ({{ .Release.Name }}-qdrant:6333)
   {{- else }}
   - Qdrant: Not deployed (configure external instance)
   {{- end }}
   {{- if .Values.ollama.enabled }}
   - Ollama: Deployed as subchart ({{ .Release.Name }}-ollama:11434)
   - Embedding Model: {{ .Values.ollama.embeddingModel }}
   {{- else if .Values.ollama.url }}
   - Ollama: Using external instance at {{ .Values.ollama.url }}
   - Embedding Model: {{ .Values.ollama.embeddingModel }}
   {{- else if .Values.openai.enabled }}
   - OpenAI: Enabled for embeddings
   {{- else }}
   - WARNING: No embedding provider configured (Ollama or OpenAI required)
   {{- end }}

   Check vector sync status:
   kubectl --namespace {{ .Release.Namespace }} exec -it deploy/{{ include "nextcloud-mcp-server.fullname" . }} -- curl -s http://localhost:{{ include "nextcloud-mcp-server.port" . }}/user/page | grep "Vector Sync"
{{- end }}

{{- if .Values.dashboards.enabled }}

6. Grafana Dashboards:
   - Dashboard provisioning: Enabled
   - ConfigMap: {{ include "nextcloud-mcp-server.fullname" . }}-dashboard
   - Grafana Folder: {{ .Values.dashboards.grafanaFolder }}

   The dashboard will be automatically imported by Grafana if the sidecar is configured
   to watch for ConfigMaps with label "grafana_dashboard: 1".

   To manually import the dashboard:
   kubectl --namespace {{ .Release.Namespace }} get configmap {{ include "nextcloud-mcp-server.fullname" . }}-dashboard -o jsonpath='{.data.nextcloud-mcp-server\.json}' | jq . > dashboard.json

   Then import dashboard.json via Grafana UI (Dashboards → Import).
{{- else }}

6. Grafana Dashboards:
   - Dashboard provisioning: Disabled
   - To enable automatic dashboard provisioning, set: dashboards.enabled=true

   Manual import option:
   The dashboard JSON is available in the chart at charts/nextcloud-mcp-server/dashboards/nextcloud-mcp-server.json
{{- end }}

{{- $legacyMultiUserBasic := eq (include "nextcloud-mcp-server.legacyMultiUserBasicPersistence" .) "true" }}
{{- $legacyQdrant := eq (include "nextcloud-mcp-server.legacyQdrantPersistence" .) "true" }}
{{- if or $legacyMultiUserBasic $legacyQdrant }}

================================================================================
                         DEPRECATION WARNING
================================================================================

You are using deprecated persistence configuration that will be removed in a
future release. Your deployment will continue to work, but please migrate to
the new unified dataStorage configuration.

Deprecated settings detected:
{{- if $legacyMultiUserBasic }}
  - auth.multiUserBasic.persistence.* (currently enabled)
{{- end }}
{{- if $legacyQdrant }}
  - qdrant.localPersistence.* (currently enabled)
{{- end }}

To migrate, update your values.yaml:

  dataStorage:
    enabled: true
{{- if $legacyMultiUserBasic }}
    size: {{ .Values.auth.multiUserBasic.persistence.size }}
{{- else if $legacyQdrant }}
    size: {{ .Values.qdrant.localPersistence.size }}
{{- end }}
    # storageClass: ""  # Optional: specify storage class
    # existingClaim: "" # Optional: use existing PVC to preserve data

After migrating, remove the deprecated settings:
{{- if $legacyMultiUserBasic }}
  - auth.multiUserBasic.persistence.enabled
  - auth.multiUserBasic.persistence.size
  - auth.multiUserBasic.persistence.storageClass
  - auth.multiUserBasic.persistence.accessMode
{{- end }}
{{- if $legacyQdrant }}
  - qdrant.localPersistence.enabled
  - qdrant.localPersistence.size
  - qdrant.localPersistence.storageClass
  - qdrant.localPersistence.accessMode
{{- end }}

================================================================================
{{- end }}

Deployed version:
  - Chart: {{ .Chart.Version }}
  - App: {{ .Chart.AppVersion }}

Full changelog: https://github.com/cbcoutinho/nextcloud-mcp-server/blob/master/charts/nextcloud-mcp-server/CHANGELOG.md

For more information and documentation:
- GitHub: https://github.com/cbcoutinho/nextcloud-mcp-server
- Documentation: https://github.com/cbcoutinho/nextcloud-mcp-server#readme

To upgrade this deployment:
  helm upgrade {{ .Release.Name }} nextcloud-mcp-server

To uninstall:
  helm uninstall {{ .Release.Name }}